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

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.

Items1 <= items <= 200

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.

Length2 <= length <= 80

limit?integer

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

Range1 <= value <= 1000

offset?integer

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

Range0 <= value

offset_token?string

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

Length1 <= length <= 2000

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

Value in"summary" | "standard" | "full"

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

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`