Developer Center
/keywords/exists POST
Allows you to check if a given keyword phrase+location+device combination exists under your account. If so, it will return the engines associated.
Required parameters
| Name | Type | Description |
|---|---|---|
| keyword | string | The keyword phrase that you wish to check exists in the daily queue. Must be UTF-8 encoded. |
| location (optional) |
string | The geolocation you would like to restrict the search to. Accepted strings include zip codes, post codes or location names. Location strings must be UTF-8 encoded and work with google only. |
| device (optional) |
string | The device to use in our User-Agent string. Accepted: desktop, tablet or mobile (defaults to desktop) |
Cost 
Free.
Example response
{
"status": "ok",
"request_time": 1332359153,
"data": {
"keyword_id": "4dc9acea045bbf04348f9691",
"keyword": "car rental alabama",
"location": null,
"device": "desktop",
"engines": ["google_en-us", "yahoo_en-us", "bing_en-us"]
}
}
Example response for a not found keyword (HTTP 404)
{
"status": "error",
"message": "not found",
"request_time": 1332359153,
}