Back to Search intent analysis

Search Intent

DataForSEO

Classify keyword intent as informational, navigational, commercial or transactional.

Current price
$0.0168/call
Availability
Ready to run
Last accepted verification

What this API does

Classifies a bounded keyword batch with a primary search intent, probability and secondary intent probabilities. The endpoint uses DataForSEO's model over keyword and SERP data and supports an explicit language. Billing is one live task plus each returned keyword classification.

Agents select this operation with tool ID dataforseo.search-intent, then inspect its current executable contract before a run.

Public input and output shape

Input

keywordsarray · required

Keyword phrases of at most 10 words each.

minItems: 1 · maxItems: 1000

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "dataforseo.search-intent",
  "input": {
    "keywords": [
      "best seo tools"
    ],
    "language_name": "English"
  }
}

Output

{
  "items": [
    {
      "keyword": "best seo tools",
      "keyword_intent": {
        "label": "commercial",
        "probability": 0.92
      },
      "secondary_keyword_intents": [
        {
          "label": "informational",
          "probability": 0.08
        }
      ]
    }
  ],
  "items_count": 1
}
Teaching errors and limitations
  • invalid_input: Provide 1–1,000 keyword phrases and a supported language.example: {"keywords":["best seo tools"],"language_name":"English"}
  • configuration_error: DataForSEO account access, funding, or cost controls blocked the request.Fund and verify the server-side DataForSEO account, then retry unchanged.
Updated
21 August 2026

Use Search Intent with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.