Pricing

Pay per event

DataForSEO SERP API - Google Organic, Maps & News Results

DataForSEO-powered SERP API. Scrape Google Organic, Google Maps and Google News results for any keywords as clean structured JSON. Set location, language, device and depth. Pay per SERP page — no DataForSEO account or subscription needed.

Pricing

Pay per event

Rating

0.0

(0)

Developer

Santhej Kallada

Actor stats

Bookmarked

Total users

Monthly active users

8 days ago

Last modified

Categories

SEO tools

Developer tools

MCP servers

You can access the DataForSEO SERP API - Google Organic, Maps & News Results programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.0",
    "x-build-id": "ctnpIHe7UAoY53YYS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/santhej~dataforseo-serp-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-santhej-dataforseo-serp-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/santhej~dataforseo-serp-api/runs": {
      "post": {
        "operationId": "runs-sync-santhej-dataforseo-serp-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/santhej~dataforseo-serp-api/run-sync": {
      "post": {
        "operationId": "run-sync-santhej-dataforseo-serp-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "One or more keywords / search queries to look up. One SERP page is fetched per query.",
            "items": {
              "type": "string"
            }
          },
          "engine": {
            "title": "Search engine",
            "enum": [
              "google_organic",
              "google_maps",
              "google_news"
            ],
            "type": "string",
            "description": "Which Google SERP to scrape.",
            "default": "google_organic"
          },
          "resultsDepth": {
            "title": "Results depth",
            "minimum": 1,
            "maximum": 700,
            "type": "integer",
            "description": "Number of results to return per query (max 700). 10 = first page.",
            "default": 10
          },
          "locationCode": {
            "title": "Location",
            "enum": [
              "2840",
              "2826",
              "2124",
              "2036",
              "2356",
              "2276",
              "2250",
              "2724",
              "2380",
              "2528",
              "2392",
              "2076",
              "2710",
              "2784"
            ],
            "type": "string",
            "description": "Geographic location for the search.",
            "default": "2840"
          },
          "languageCode": {
            "title": "Language code",
            "type": "string",
            "description": "Two-letter language code, e.g. 'en', 'es', 'de', 'fr'.",
            "default": "en"
          },
          "device": {
            "title": "Device",
            "enum": [
              "desktop",
              "mobile"
            ],
            "type": "string",
            "description": "Device type for Organic and News results (ignored for Maps).",
            "default": "desktop"
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

DataForSEO SERP API - Google Organic, Maps & News Results OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for DataForSEO SERP API - Google Organic, Maps & News Results from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

DataForSEO SERP API - Google Organic, Maps & News Results API in Python

DataForSEO SERP API - Google Organic, Maps & News Results API in JavaScript

DataForSEO SERP API - Google Organic, Maps & News Results API through CLI

DataForSEO SERP API - Google Organic, Maps & News Results API

DataForSEO SERP Tracker

alizarin_refrigerator-owner/dataforseo-serp

Track keyword rankings, analyze SERPs & perform keyword research using DataForSEO API. Get organic results, featured snippets, people also ask & more for any keyword. Live SERP Analysis, Keyword Research, Ranked Keywords, Competitor Analysis, Multi-Device, BYOK: Bring your own DataForSEO API creds

The Howlers

AI SERP Visibility Monitor - DataForSEO Rank API

changeable_peddler/ai-serp-visibility-monitor

Analyze Google top-10 SERP visibility, competitor rankings, and AI Overview mentions or citations for target domains using DataForSEO.

Sean

DataForSEO API Gateway - Run Any Endpoint, No Subscription

santhej/dataforseo-api-gateway

Call ANY DataForSEO API endpoint pay-per-use through Apify — no DataForSEO account or subscription required. SERP, Keywords, Labs, Backlinks, On-Page, Merchant, Business Data & more. Just pass the endpoint path + payload and get structured JSON back.

Santhej Kallada

Google Search Results Serp Scraper

scrapio/google-search-results-serp-scraper

Google Search Results SERP Scraper 🔎📄 extracts organic results, ads, titles, URLs, snippets, and ranking data from Google search pages. Ideal for SEO tracking, competitor research, keyword analysis, and SERP monitoring. Fast, scalable, and automation-ready. 🚀📊

Scrapio

DataForSEO Labs - Keyword Ideas, Difficulty & Competitors

santhej/dataforseo-labs-keyword-explorer

DataForSEO Labs keyword toolkit. Get keyword suggestions, related keywords, keyword difficulty, search intent, and a competitor's ranked keywords as structured JSON. Pay per keyword — no DataForSEO account or subscription needed.

Santhej Kallada

5.0

Google Search Scraper — Organic Results & SERP Data Extractor

maged120/google-search

Scrape Google organic search results for any query. Returns titles, URLs, snippets, and result positions — no Google Search API key or quota needed.

Maged

Google SERP Scraper

google-serp-scraper-api/google-serp-scraper

Scrapes Google search results, autocomplete suggestions, and Google News.

Kevin

CrazySerp

crazyserp/crazyserp

Google Serp API Scrape Google Search Results with a single API call. Get structured JSON data from Google Search including organic results, news, images, videos, and 20+ more data types.

Crazy Serp

Google Search Results (Serp) Scraper

scraper-engine/google-search-results-serp-scraper

Google Search Results Serp Scraper is an Apify actor that extracts structured data from Google search results pages. Collect organic results, ads, titles, URLs, snippets, and rankings in JSON or CSV. Ideal for SEO analysis, keyword tracking, and competitor research.

Scraper Engine

Google SERP Extractor

tropical_prune/google-serp-extractor

Extract Google SERP results including organic results, paid results, knowledge panels, and People Also Ask. Supports multiple queries with country/language options. Outputs structured JSON or markdown.