For a given portal, return information about a specific prospect organization in JSON format.
Note that the organization in the URL must be an organization matching one on the timeline for this customer. See the timeline method response for an example.
| Required Parameters | How to use | Description |
|---|---|---|
| HubSpot OAuth Access Token | access_token=X - Used in the request URL | The HubSpot API key for the portal that you're making the call for. |
| Organization | Used in the request URL (see request URL) | The organization you're requesting prospects from. Please Note That if the company that you're looking for contains a space in its name, then you need to replace that space with a dash ("-") character. URL encoding the space (replacing with a "%20" will not work and return 404. |
| Optional Parameters | How to use | Description |
|---|---|---|
| None | None | No optional parameters for this method. |
Example URL: https://api.hubapi.com/prospects/v1/timeline/PRNEWSWIRE?access_token=demooooo-oooo-oooo-oooo-oooooooooooo
Example JSON response:
{
"summary": {
"slug": "prnewswire",
"organization": "PRNEWSWIRE",
"page-views": 39,
"visitors": 4,
"timestamp": 1322509090,
"city": "JERSEY CITY",
"region": "NEW JERSEY",
"country": "UNITED STATES",
"url": "PRNEWSWIRE.COM",
"leads": 0,
"longitude": -74.077644,
"latitude": 40.728157,
"ip-address": "205.217.162.54",
"touches": [
{
"keyword": "hugs50 hubspot",
"keyword-engine": "google",
"child-id": "300291"
}
]
},
"activities": []
}
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers