Skip to main content
POST
Add GEO topics

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

Path Parameters

project_id
string<uuid>
required

Body

application/json

Request body for adding GEO / AI Visibility topics to a project.

Topics represent keyword phrases for which the platform will track how often the project's domain is cited in AI-generated responses.

keywords
string[]
required

List of keywords/topics to track for AI visibility. Maximum 100 keywords per request. Duplicates are silently ignored.

Required array length: 1 - 100 elements
location_code
integer
required

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

language_code
string
required

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

Maximum string length: 10

Response

Successful Response

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