Help Center

  • Fill out my online form
  • How to get keywords a domain/URL ranks for?

    With DataForSEO Labs API, you can enrich your tool with ranking keywords data.

    Using the Ranked Keywords endpoint, it’s easy to discover ranking keywords of any domain/URL on the web, along with valuable keyword metrics.

    POST https://api.dataforseo.com/v3/dataforseo_labs/ranked_keywords/live

    How to get keywords a domain ranks for

    1To get ranking keywords of a domain, specify the domain name without https:// and www in the target field of the Task POST array.

    2You can also specify location_name (or location_code) and language_name (or language code) to get country-specific keyword metrics and rankings. If you ignore these fields, the API will return global data.

    To get the full list of locations and languages for DataForSEO Labs API, call the Locations and Languages endpoint.

    GET https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages

    3Set the limit on the number of returned keywords by adding the limit field to the Task POST array. Note that the Ranked Keywords endpoint can return no more than 1000 keywords per one request. Thus, the maximum limit value can be 1000. If you don’t add this parameter, the API response will return 100 keywords as the default limit value is 100.

    Your Task POST request should be structured as in the example below.

    [
        {
            "target": "dataforseo.com",
            "language_name": "English",
            "location_code": 2840,
            "limit": 50
        }
    ]

    How to get keywords a URL ranks for

    To get ranking keywords data for a particular URL of the domain, simply add the filters field with the ranked_serp_element.serp_item.relative_url parameter to the Task POST array.

    Example:

    [
        {
            "target": "dataforseo.com",
            "language_name": "English",
            "location_code": 2840,
            "limit": 50,
            "filters": ["ranked_serp_element.serp_item.relative_url", "=", "/blog/backlinks-api-now-in-dataforseo"]
        }
    ]