Developer Center
/keywords/serp POST
Allows you to pull the top ~100 results for the given check_id (dependant on the engine, phrase and user-agent combination).
Required parameters
| Name | Type | Description |
|---|---|---|
| check_id | string | The check_id supplied by the /keywords/check endpoint, or the callback facility. |
Optional parameters
| Name | Type | Description |
|---|---|---|
| domain | string | Restrict results to only those that match the given root domain. |
Cost 
Free
Example response
The JSON response contains two arrays that you need to be aware of. The "pages" section is deprecated and can be ignored (included only for backwards compatibility).
The results section is returned as a key/value; with the key being the result position number and the value being an array of the result data. Below is a cut-down example JSON response, and below that is a table explaining possible result attributes.
{
"status": "ok",
"request_time": 1332359153,
"data": {
"pages": {
"1": 1,
},
"results": {
"1": {
"href": "http:\/\/www.firstpizza.com\/",
"title": "America's First Pizzeria | Little Italy New York | Lombardi's",
"desc": "Lombardi's was founded in 1905, making it the first pizzeria in the United States. Still located in the Little Italy section of Manhattan offering its ...",
"contains": {
"sitelinks": [
"1": {
"title": "Menu",
"href": "http:\/\/www.firstpizza.com\/menu.html"
},
"2": {
"title": "Lombardi's Pizza",
"href": "http:\/\/www.firstpizza.com\/newyork.html"
},
"3": {
"title": "Reviews",
"href": "http:\/\/www.firstpizza.com\/reviews.html"
}
]
},
},
"2": {
"href": "https:\/\/www.joecristianospizza.com\/",
"title": "Joe Cristiano's Pizza",
"desc": "Joe Cristiano's Pizza is your neighborhood pizzeria offering pizza, wings, salad and pasta, offering eat-in, take-out and free delivery."
},
/* ----- snip ----- */
"100": {
"href": "http:\/\/www.youtube.com\/watch?v=-3F8cJFBNN0",
"title": "Gluten Free Pizza Nyc - YouTube",
"desc": "Jun 7, 2012 - 49 sec - Uploaded by unevenhuman28xL Go Here: http:\/\/opennewspress.com\/pizzasyearly This gluten-free pizza dough can be rolled out, just like ...",
"type": "universal:video"
}
},
"resultCount": "131000000",
"engineCode": "google_en-us",
"timestamp": 1339977766,
"query": "pizza nyc"
}
}
Result attributes
| Name | Type | Description |
|---|---|---|
| href | string | The URL of the result. |
| title | string | The title snippet of the result. |
| desc | string | The description snippet of the result. |
| contains | array | A list (array) of tagged information contained with the result. Where a 'contains' type has extra data, this is delivered as a further array value:
|
| type | string (or array of strings) | The type of result returned, which can occasionally be mixed:
|
| attributes | array | Attributes that are included within some universal/blended results:
|
| items | array | Some result types contain lists of items (e.g., universal:images, universal:news, etc.). Legacy item extractions contain one or more of the following:
|