/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 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,
}
            

Comments