Find keyword suggestions

Expand a seed keyword into long-tail search queries that include it, 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.

keyword*string

Seed keyword. Returns long-tail search queries that include this keyword.

Length1 <= length <= 80

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 suggestions to return. Defaults to 100.

Range1 <= value <= 1000

offset?integer

Number of keyword suggestions 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

exact_match?boolean

When true, return only suggestions that contain the exact seed keyword in the same word order.

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.

include_seed_keyword?boolean

When true, include metrics for the seed keyword in the response.

view?string

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

Response Body

`application/json`

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

{
  "request_id": "string",
  "data": {
    "seed_keyword": "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
    }
  }
}

Find keyword suggestions

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`