YepAPI

Command Palette

Search for a command to run...

POST/v1/seo/keywords/intent

Search Intent API

Search intent API that classifies keywords as informational, commercial, navigational or transactional in bulk. From $0.02/call.

Classify the search intent behind any keyword. Each term is labeled informational, commercial, navigational, or transactional, with a confidence probability and any secondary intents — so you can match content format to what the searcher actually wants.

Try it live

Fill in the fields and hit Run to see a real response.

POST/v1/seo/keywords/intent

One keyword per line. Up to 1,000 per request.

Two-letter language code (default en).

Response
Example response — hit "Send Request" to see a live result
{
  "ok": true,
  "data": {
    "keywords": [
      {
        "keyword": "seo api",
        "intent": "informational",
        "probability": 0.972,
        "secondaryIntents": []
      },
      {
        "keyword": "buy running shoes",
        "intent": "transactional",
        "probability": 1,
        "secondaryIntents": []
      }
    ]
  }
}

Features

Four-way intent classification

Every keyword is tagged informational, commercial, navigational, or transactional, so you know whether a searcher wants to learn, compare, navigate, or buy before you write a word.

Confidence probability per keyword

Each classification carries a 0–1 probability, letting you trust the clear cases and flag the ambiguous ones for review instead of treating every label as equal.

Secondary intents surfaced

When a keyword straddles more than one intent, the response lists secondary intents too, so mixed-intent terms don't get forced into a single bucket.

Batch classification

Send a full keyword list — one per line — and classify every term in a single call, ready to route into content briefs or page-type decisions programmatically.

Use cases

Content Format Selection

Route each keyword to the right page type — guide, comparison, or product page — based on its classified intent.

Funnel Mapping

Group a keyword list by intent to map coverage across the awareness, consideration, and purchase stages.

PPC vs SEO Routing

Send high-intent transactional terms to paid campaigns and informational terms to organic content automatically.

Quick start

Copy this snippet and start making calls.

const res = await fetch('https://api.yepapi.com/v1/seo/keywords/intent', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "keywords": [
      "seo api",
      "buy running shoes",
      "login to gmail"
    ],
    "language": "en"
  }),
});
const data = await res.json();
console.log(data);

The search intent API for developers — classify keyword intent at scale

The search intent API classifies each keyword as informational, commercial, navigational, or transactional, with a confidence probability and any secondary intents. Post a list of terms and get a clean intent label for every one — the signal that decides what kind of page each keyword deserves.

As a keyword intent API it slots in beside the Keyword Overview and Bulk Keyword Difficulty endpoints under a single YepAPI key, so discovery, scoring, and intent classification all run through the same auth and response conventions.

Unlike a manual search intent tool where you eyeball the SERP one query at a time, this endpoint labels up to 1,000 keywords per call, so you can map the intent of an entire keyword universe in seconds and route each term to the right content format automatically.

What is a search intent API?

A search intent API returns the goal behind a query as data. For each keyword you get one of four labels — informational, commercial, navigational, transactional — plus a probability and any secondary intents. That lets you automate content decisions: guides for informational terms, comparison pages for commercial ones, product pages for transactional ones. YepAPI serves this from /v1/seo/keywords/intent — post a keyword list and a language and receive a labeled array.

What are the four types of search intent?

Search intent falls into four buckets. Informational queries want to learn ('how does an API work'). Commercial queries compare options before buying ('best seo api'). Navigational queries look for a specific site or brand ('yepapi login'). Transactional queries are ready to act ('buy running shoes'). The search intent API returns one primary label per keyword plus a probability, so you can serve guides to informational terms, comparison pages to commercial ones, and product or signup pages to transactional ones.

Search intent API pricing — $0.02 per call

Pricing is $0.02 per call with no seats and no monthly minimum. Intent data is usually bundled into enterprise SEO suites; YepAPI meters it per request with $5 of free credit, so classifying a large keyword universe costs cents rather than a subscription.

Start making API calls in 30 seconds

$5 free credit on signup. No credit card required. Pay per call.

A pay-per-call Semrush & Ahrefs API alternative

YepAPI gives you the same data with simpler pricing. One API key, pay per call, no subscriptions.

Provider
Pricing
Catch
Semrush API
Subscription
Enterprise plan required
Ahrefs API
Subscription
$999/mo plan, no pay-per-call
SpyFu
Subscription
Seat-based subscription
YepAPI
$0.02/call
No minimums

What developers say

Switched from SerpAPI and cut our SERP costs by 80%. Same data quality, way simpler billing.

Marcus T.

SEO Platform Founder

One API key for AI models, SERP data, and web scraping. Saved us from managing 4 separate providers.

Priya S.

Full-Stack Developer

The $5 free credit let us prototype our entire rank tracking feature before committing. No other API does that.

Jake R.

Indie Hacker

Frequently asked questions

Classify the search intent behind any keyword. Each term is labeled informational, commercial, navigational, or transactional, with a confidence probability and any secondary intents — so you can match content format to what the searcher actually wants.

Each API call costs $0.02. No monthly minimums or subscriptions — you only pay for what you use.

Sign up for a free API key, then send a POST request to /v1/seo/keywords/intent. Check the code example above for a ready-to-use snippet in JavaScript, cURL, or Python.

YepAPI bundles SEO, AI, and web scraping APIs under one key with no monthly minimums. You get lower per-call pricing, a unified dashboard, and one billing account instead of managing multiple providers.

Informational (the searcher wants to learn), commercial (comparing options before a purchase), navigational (looking for a specific site or brand), and transactional (ready to buy or act). The API returns one of these four labels for every keyword, along with a confidence probability and any secondary intents when a term straddles more than one.

Intent is inferred from the language of the query and the type of results Google returns for it — a SERP full of product pages signals transactional intent, one full of how-to guides signals informational. YepAPI condenses these signals into a single label per keyword with a 0–1 probability score, so you can trust the confident classifications and flag borderline ones for review.

Yes — send up to 1,000 keywords per call, one per line, and every term comes back labeled in a single response. That makes it practical to classify an entire keyword list at once and group it by intent for funnel mapping or content planning, at $0.02 per call.

A search intent tool is usually a dashboard where you check queries one at a time. A keyword intent API returns the same labels as structured data over HTTP, so you can classify thousands of keywords programmatically and pipe the results straight into content briefs, PPC-vs-SEO routing, or an AI agent.

YepAPI's $5 signup credit covers 250 calls of up to 1,000 keywords each, so you can classify intent for hundreds of thousands of keywords before paying. After that it's $0.02 per call with no subscription.

Ready to integrate?

Get your API key and start making calls in 30 seconds. $5 free credit on signup — no credit card required.

More seo apis endpoints