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.