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.

Pricing — $$ · min $0.05

Minimum 50 credits ($0.05) per call. Records returned above the minimum bill 1 credit ($0.001) each.

Authorization

bearerAuth

AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Header Parameters

Unifapi-Version?string

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Idempotency-Key?string

Client-supplied unique key that makes a write request safe to retry. If a request with the same key was already processed, the original response is replayed (with Idempotency-Replayed: true) instead of executing — and billing — again. Send a fresh UUID per logical operation. Best-effort with a 24h window.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

keywords*array<>

Seed keywords (1-200). Returns search terms relevant to the product or service categories of these keywords.

location?|

Search location as a country code/name, DataForSEO location code, or full location name. Defaults to us.

language?string

Search language as an ISO code or full language name. Defaults to en.

limit?integer

Maximum number of keyword ideas to return. Defaults to 100.

offset?integer

Number of keyword ideas to skip from the start of the results.

offset_token?string

Pagination token from a previous response. When set, all other params except limit are ignored.

closely_variants?boolean

When true, use phrase-match search; when false (default), use broad-match search for wider ideas.

ignore_synonyms?boolean

When true, exclude highly similar keywords and return only core keywords.

include_serp_info?boolean

When true, include SERP data (result count and SERP feature types) for each keyword. Can add source cost.

view?string

Response Body

`application/json`

curl -X POST "https://example.com/seo/keywords/ideas" \  -H "Content-Type: application/json" \  -d '{    "keywords": [      "string"    ]  }'

{  "request_id": "string",  "data": {    "seed_keywords": [      "string"    ],    "location": "string",    "language": "string",    "view": "summary",    "total_count": 0,    "offset": 0,    "offset_token": "string",    "results": [      {        "keyword": "string",        "search_volume": 0,        "cpc": 0,        "competition": 0,        "competition_level": "string",        "keyword_difficulty": 0,        "search_intent": "string",        "search_intent_alternatives": [          "string"        ],        "low_top_of_page_bid": 0,        "high_top_of_page_bid": 0,        "words_count": 0,        "detected_language": "string",        "search_volume_trend": {          "monthly": 0,          "quarterly": 0,          "yearly": 0        },        "serp_item_types": [          "string"        ],        "serp_results_count": 0,        "monthly_searches": [          {            "year": 0,            "month": 0,            "search_volume": 0          }        ],        "last_updated_at": "string"      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

Discover keyword ideas

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

429application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`