DataForSEO

The whole DataForSEO REST API behind one wildcard route
View as Markdown

Proxies the entire DataForSEO REST API — SERP, Keywords Data, Backlinks, On-Page, DataForSEO Labs, Merchant, and more. Like ElevenLabs, it’s a whole API surface, so the gateway mounts a wildcard and forwards the path after /dataforseo/ verbatim:

GET|POST /dataforseo/<api path> → https://api.dataforseo.com/<api path>

Because the path passes through unchanged, new DataForSEO endpoints work without any gateway change. Each endpoint is a task_post / task_get / live variant under /v3. The methods mirror what DataForSEO documents — POST for task_post and live, GET for task_get, tasks_ready, and user_data.

Common paths

PathPurpose
POST /dataforseo/v3/serp/google/organic/live/advancedLive Google SERP
POST /dataforseo/v3/keywords_data/google_ads/search_volume/liveKeyword search volume
POST /dataforseo/v3/backlinks/summary/liveBacklinks summary
POST /dataforseo/v3/on_page/instant_pagesOn-Page analysis
POST /dataforseo/v3/dataforseo_labs/google/keyword_ideas/liveLabs keyword ideas
GET /dataforseo/v3/appendix/user_dataAccount data

What the gateway injects and strips

DataForSEO authenticates with HTTP Basic auth (Authorization: Basic <base64 of login:password>) — reusing the Authorization header you use for your gateway token. So the gateway overwrites it with the injected credential:

  • The Authorization header is overwritten with the secret DataForSEO Basic credential. You never send your DataForSEO login or password; your gateway token is consumed by the gateway and never reaches DataForSEO.
  • DataForSEO has no query-param spelling of the credential, so nothing is dropped from the query string.

Examples

$curl -X POST "$GATEWAY/dataforseo/v3/serp/google/organic/live/advanced" \
> -H "Authorization: Bearer $TOKEN" \
> -H "Content-Type: application/json" \
> -d '[{"keyword": "coffee", "location_code": 2840, "language_code": "en"}]'

The response is DataForSEO’s JSON, returned unchanged. For request and response fields, follow DataForSEO’s documentation — the gateway does not alter them.