Skip to main content
POST
Create a project

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

org_id
string<uuid>
required

Body

application/json

Request body for creating a new project.

name
string
required

Human-readable project name

Required string length: 2 - 255
domain
string
required

Root domain being tracked (e.g., 'example.com')

Required string length: 3 - 255
keywords
string[]
required

Initial keywords to track (at least 1 required)

Minimum array length: 1
location_code
integer
required

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

language_code
string
required

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

Maximum string length: 10
search_engine
string
default:google

Search engine for rank tracking (e.g. 'google', 'bing', 'yahoo')

Maximum string length: 20
competitors
string[]

Optional competitor domains to track

settings
Settings · object

Optional project-specific settings (e.g., target location, language)

Response

Successful Response

success
boolean
default:true
data
ProjectResponse · object | null

Project data returned by API endpoints.