HELP CENTER

What are the input parameters of DataForSEO Labs Search Intent API?

To make a request to DataForSEO Labs Search Intent API it is required to specify only two parameters: keywords and language_code or language_name.

Both have certain requirements, so let’s look at them in more detail:

1You can specify up to 1000 keywords in a row. Each keyword should be at least 3 characters long. In the API response, all of them will be converted to a lowercase format.

2Use one of the language_code and language_name parameters. To receive the list of available languages with their code and name make a separate request to https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages.

Example request:

[
  {
    "language_code": "en",
    "keywords": [
      "login page",
      "Audi A7",
      "Elon Musk",
      "milk store new york"
    ]
  }
]

Besides the highest probable search intent, the results will also provide you with other likely search intent(s) and their probability.

{
  "version": "0.1.20221214",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0760 sec.",
  "cost": 0.0014,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "03161326-4426-0541-0000-227cbd5694c7",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0232 sec.",
      "cost": 0.0014,
      "result_count": 1,
      "path": [
        "v3",
        "dataforseo_labs",
        "google",
        "search_intent",
        "live"
      ],
      "data": {
        "api": "dataforseo_labs",
        "function": "search_intent",
        "se_type": "google",
        "language_code": "en",
        "keywords": [
          "login page",
          "Audi A7",
          "Elon Musk",
          "milk store new york"
        ]
      },
      "result": [
        {
          "language_code": "en",
          "items_count": 4,
          "items": [
            {
              "keyword": "login page",
              "keyword_intent": {
                "label": "navigational",
                "probability": 0.9694191
              },
              "secondary_keyword_intents": null
            },
            {
              "keyword": "audi a7",
              "keyword_intent": {
                "label": "commercial",
                "probability": 1
              },
              "secondary_keyword_intents": null
            },
            {
              "keyword": "elon musk",
              "keyword_intent": {
                "label": "informational",
                "probability": 0.95328856
              },
              "secondary_keyword_intents": null
            },
            {
              "keyword": "milk store new york",
              "keyword_intent": {
                "label": "commercial",
                "probability": 0.49751797
              },
              "secondary_keyword_intents": [
                {
                  "label": "transactional",
                  "probability": 0.37083894
                },
                {
                  "label": "informational",
                  "probability": 0.30781138
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Note that: You can send up to 2000 API calls per minute. The maximum number of requests that can be sent simultaneously is limited to 30.

Embed DataForSeo widget on your website


Embed code:
Preview: