DataForSEO drop-in

Already integrated with DataForSEO? Serplify’s /v3 API is a drop-in replacement for DataForSEO’s Google Organic SERP endpoints. Keep your code, keep your request/response parsing — just change the base URL and use a Serplify API key.

Note

This page describes the legacy /v3 compatibility surface. For new work, prefer the native /v1 API — it has real HTTP status codes, a cleaner envelope, and rank tracking.

What changes

	DataForSEO	Serplify drop-in
Base URL	https://api.dataforseo.com	https://api.serplify.io
Auth	Basic auth (login:password)	Authorization: Bearer live_…
Endpoints	/v3/serp/google/organic/*	identical paths
Envelope	tasks[].result[], HTTP 200 always	identical
Status codes	5-digit (20000, 40101, …)	identical

Everything else — the request array shape, location_code/language_code, live/{regular,advanced,html}, task_post → tasks_ready → task_get, pingback/postback — matches.

Supported /v3 endpoints

Method	Path
POST	/v3/serp/google/organic/task_post
POST	/v3/serp/google/organic/live/regular
POST	/v3/serp/google/organic/live/advanced
POST	/v3/serp/google/organic/live/html
GET	/v3/serp/google/organic/task_get/{regular,advanced,html}/{id}
GET	/v3/serp/google/organic/tasks_ready
GET	/v3/serp/google/locations · /v3/serp/google/locations/{country_iso}
GET	/v3/serp/google/languages

Example

curl -X POST https://api.serplify.io/v3/serp/google/organic/live/advanced \
  -H "Authorization: Bearer live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "keyword": "best running shoes",
      "location_code": 2840,
      "language_code": "en",
      "device": "desktop"
    }
  ]'

The response is the familiar DataForSEO envelope:

{
  "version": "0.1.0",
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "id": "…",
      "status_code": 20000,
      "result": [ { "keyword": "best running shoes", "items": [ /* … */ ] } ]
    }
  ]
}

Migration checklist

1. Swap the base URL to https://api.serplify.io.
2. Replace Basic auth with Authorization: Bearer <your Serplify key>.
3. Keep your existing request bodies and response parsing as-is.
4. Verify a live/advanced call end-to-end.
5. When ready, adopt the native /v1 API for new features like rank tracking.

Differences to know

• Pricing — Serplify bills a flat $0.005 per successful SERP on one prepaid balance, and only successful fetches are charged.
• Auth — bearer key, not login:password.
• Scope — Serplify’s drop-in covers Google Organic SERP. Other DataForSEO APIs are not part of the drop-in.