Classify keyword search intent · SEO API
Return the search intent (informational, navigational, commercial, or transactional) with probabilities for up to 1,000 keywords, for mapping keywords to the right content type.
Using ChatGPT, Claude Code or another client? See the setup steps
curl -X POST https://api.unifapi.com/seo/keywords/intent \ -H "Authorization: Bearer $UNIFAPI_KEY" \ -H "Content-Type: application/json"
Parameters
- The parameter for this SEO operation. Use the URL-visible slug or id described in the docs.
- The parameter for this SEO operation. Use the URL-visible slug or id described in the docs.
This operation is part of the SEO API in the seo category. It uses the same Bearer token, request tracing, error model, and billing envelope as every UnifAPI endpoint, so agents can switch between platforms without custom per-vendor glue code.
Use it when a workflow needs SEO public data but should still keep one API key, one account balance, and one predictable JSON contract across social, live public-data sources.
Common agent workflows
- Search SEO for public mentions, creators, posts, or topics matching a user query.
- Feed ranked SEO results into research, monitoring, and enrichment workflows.
- Give an AI agent a stable SEO data source without building a per-platform integration.
- Normalize SEO responses into the same UnifAPI envelope used across the catalog.
Unified envelope, platform-native fields
- List-style responses return `data` as an array of top-level records plus optional `pagination` for continuation tokens or cursors.
- The operation has a 10 credits ($0.01) minimum charge, so `billing.records_charged` can be higher than the visible records returned.
- If the workspace balance cannot cover every result, the response can be truncated and `billing.truncated_due_to_balance` tells the caller why.
Response status codes
Billing
This operation charges 1 credit per billable record, with a 10 credits ($0.01) operation minimum. Public responses include billing metadata with credits charged, records charged, and remaining workspace balance. Incorrect Credit deductions caused by platform failures can be restored as billing corrections.
Errors and retries
Authentication, validation, rate-limit, not-found, and provider errors use the unified UnifAPI error format. Agents should log `request_id`, retry only retryable failures, and treat invalid API keys, disabled keys, and expired keys as the same public `unauthorized` error type.
Fields in the data object
A successful Classify keyword search intent call returns one data object with these fields.
- keywordsstring[]
- Keywords echoed from the request.
- languagestring
- resultsobject[]
- Search intent per keyword. Each keyword is one billable record.
- results[].keywordstring
- Keyword phrase.
- results[].search_intentstring
- Main search intent: informational, navigational, commercial, or transactional.
- results[].probabilitynumber
- Probability of the main search intent, where 1 is highest.
- results[].secondary_intentsobject[]
- Other likely search intents for the keyword with their probabilities.
Agents & Skills built on SEO
You rarely call Classify keyword search intent by hand. These prebuilt agents and skills already read SEO data inside Claude or Codex — start from one of them, or call this endpoint yourself.
Try it free in the browser
Keyword search volume checker
Check monthly search volume, difficulty, intent, and CPC for up to 10 keywords.
Keyword generator — ideas, volume & difficulty
Turn one seed keyword into hundreds of related terms with volume and difficulty.
Backlink checker
Referring domains, total backlinks, backlink rank and spam score for any domain.
Domain authority & traffic checker
Authority score, estimated organic traffic and ranked keywords for any domain.
Agents
Skills
More SEO operations
Combine endpoints from the same platform, then join the results with other UnifAPI categories without changing authentication or response parsing.
Discover keyword ideas
Expand seed keywords into related search terms that fall into the same product or service categories, each with search volume, CPC, competition, keyword difficulty, and search intent for SEO and content research.
Look up keyword metrics
Return current SEO metrics for specified keywords, including search volume, CPC, competition, keyword difficulty, and search intent, for prioritizing keyword targets.
Collect autocomplete keyword suggestions
Run one live autocomplete lookup for a seed query and receive the suggested searches the engine offers, with relevance scores — useful for SEO keyword discovery and content-gap research.
Score keyword difficulty
Return the keyword difficulty (0-100 chance of ranking in the top-10 organic results) for up to 1,000 keywords in one request, for prioritizing achievable SEO targets.
Find keywords a domain ranks for
Return the keywords a target domain is relevant for, each with search volume, CPC, competition, keyword difficulty, and search intent, for competitor and own-site keyword research.
Get historical keyword data
Return historical search volume and search ad metrics since 2019 for specified keywords, for trend and seasonality analysis.