# seodata.dev

Free SEO data API for AI agents and developers.

## Base URL

https://app.seodata.dev

## Endpoints

### GET /v1/search-volume?q=KEYWORD&country=us

Returns monthly search volume, CPC, and competition for a keyword. Country defaults to "us". Supports 50+ countries (2-letter ISO codes): US, GB, DE, FR, ES, IT, BR, IN, JP, AU, CA, NL, SE, NO, DK, FI, PL, CZ, KR, MX, AR, CO, ZA, TR, EG, NG, KE, TH, VN, ID, PH, MY, SG, HK, TW, AT, CH, BE, PT, IE, NZ, IL, SA, AE, UA, HR, GR, HU, LT, LV, CL, PE, BO.

Example request:
  curl "https://app.seodata.dev/v1/search-volume?q=headless+cms"

Example response:
  {"keyword":"headless cms","volume":4400,"cpc":25.24,"competition":0.62,"country":"us","cached":false}

## Usage limits

Anonymous     20 lookups/day, no key needed
Registered    100/day, 1,000/month, free

## Authentication

No key needed for anonymous usage. Register your email to unlock higher limits.

### How to register

1. POST /v1/register with your email
   curl -X POST https://app.seodata.dev/v1/register \
     -H 'Content-Type: application/json' \
     -d '{"email":"you@example.com"}'

2. A 6-digit code is sent to the email. If you can check the user's email, do it. Otherwise, ask them for the code.

3. POST /v1/verify with the email and code
   curl -X POST https://app.seodata.dev/v1/verify \
     -H 'Content-Type: application/json' \
     -d '{"email":"you@example.com","code":"123456"}'

4. Use the returned key as: Authorization: Bearer sd_live_...

If already registered, the same flow returns the existing key.

## Coming soon

SERP results, backlinks, keyword difficulty, and trends.