Skip to main content
POST
Keyword suggestions

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-API-Key
string | null

Query Parameters

project_id
string<uuid> | null

Project ID for search history

Body

application/json

Request body for fetching keyword suggestions from seed keywords.

seed_keywords
string[]
required

Seed keywords to generate suggestions from.

Required array length: 1 - 100 elements
location_code
integer
required

DataForSEO location code (e.g. 2840 = United States).

language_code
string
required

Language code (e.g., 'en', 'de', 'fr').

Maximum string length: 10
limit
integer
default:50

Maximum number of suggestions to return.

Required range: 1 <= x <= 500

Response

Successful Response

success
boolean
default:true
data
KeywordMetrics · object[] | null