For a given keyword, return information about the keyword in JSON or XML format.
| Required Parameters | How to use | Description |
|---|---|---|
| Keyword GUID | Used in the request URL | Unique identifier for a particular keyword. |
| 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. |
| Optional Parameters | How to use | Description |
|---|---|---|
| None | None | No optional parameters for this method. |
Example URL requesting JSON: https://api.hubapi.com/keywords/v1/keywords/6bde2815-81b8-452c-81dd-7854551bab8d.json?access_token=demooooo-oooo-oooo-oooo-oooooooooooo
Example JSON output is below. Please note that if a keyword has traffic attributed to it, we'll append some other fields to it based on the visits and lead data associated with that keyword:
{
"keyword": "app",
"visits": 18,
"keyword_guid": "00e8568a-ca6a-4743-90a4-9dfb9b308a31",
"leads": 9,
"created_at": 1326410035595
}
Example URL requesting XML: https://api.hubapi.com/keywords/v1/keywords/6bde2815-81b8-452c-81dd-7854551bab8d.xml?access_token=demooooo-oooo-oooo-oooo-oooooooooooo
Example XML output. Please note that if a keyword has traffic attributed to it, we'll append some other fields to it based on the visits and lead data associated with that keyword:
<List>
<keywords>
<keyword>app</keywordkeyword>
<visits>18</visits>
<keyword_guid>00e8568a-ca6a-4743-90a4-9dfb9b308a31</keyword_guid>
<leads>9</leads>
<created_at>1326410035595</created_at>
</keywords>
</List>
HTTP Methods:
GET
Response Format:
json, xml
Requires Authentication?
Yes
Rate Limited?
Headers