About this endpoint
What it does
Expands a single input keyword into a related-keywords result set. The endpoint takes a keyword query parameter, optionally limits the number of returned results with limit, and returns the original query string plus an array of related keyword objects.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| keyword | String | Yes | The keyword to expand. Must be at least 1 character long. |
| limit | Integer | No | Maximum number of related keywords to return. Default: 25. Minimum: 1. Maximum: 200. |
Response
Returns a JSON object with a query string field and a results array field. Each item in results is an object containing keyword as a string, score as a number, and pair_count as an integer.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| query | String | Yes | The keyword query that was expanded. |
| results | Object Array | Yes | The related-keywords results. Each item includes keyword, score, and pair_count. |
| results[].keyword | String | Yes | A related keyword. |
| results[].score | Number | Yes | The score associated with the related keyword. |
| results[].pair_count | Integer | Yes | The pair count associated with the related keyword. |



