Google SERP

5 credits

Get full Google Search Engine Results Page data.

POST/api/v1/tools/google/serp

Parameters

qstringrequired

Search query.

glstring

Country code (2 letters, e.g. "us", "uk").

hlstring

Language code (2-5 chars, e.g. "en", "en-US").

locationstring

City or region for geo-targeted results (e.g. "San Francisco", "London").

sortstring

Sort parameter.

maxPagesnumber

Max pages to fetch (1-10). Defaults to 1.

Response Schema

dataobject

SERP result containing all extracted sections

organicobject[]

Organic search results

knowledgePanelobject | null

Knowledge panel data, if present

localobject[]

Local pack results

newsobject[]

News results

featuredSnippetobject | null

Featured snippet, if present

metaobject

Request metadata

toolstring

Tool name (google-serp)

creditsUsednumber

Credits consumed (5)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/google/serp \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "q": "best restaurants san francisco",
    "gl": "us"
  }'

Response Example

{
  "data": {
    "organic": [
      {
        "title": "15 Best Restaurants in San Francisco - Eater SF",
        "url": "https://sf.eater.com/maps/best-restaurants-san-francisco",
        "snippet": "The essential restaurants to visit in San Francisco right now, from fine dining to casual neighborhood spots.",
        "position": 1
      }
    ],
    "knowledgePanel": null,
    "local": [
      {
        "title": "House of Prime Rib",
        "rating": 4.6,
        "reviewCount": 5200,
        "address": "1906 Van Ness Ave"
      }
    ],
    "news": [],
    "featuredSnippet": null
  },
  "meta": {
    "tool": "google-serp",
    "creditsUsed": 5,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/google/serp \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"q": "best restaurants san francisco",

"gl": "us"

{

"data": {

"organic": [

{

"title": "15 Best Restaurants in San Francisco - Eater SF",

"url": "https://sf.eater.com/maps/best-restaurants-san-francisco",

"snippet": "The essential restaurants to visit in San Francisco right now, from fine dining to casual neighborhood spots.",

"position": 1

}

"knowledgePanel": null,

"local": [

{

"title": "House of Prime Rib",

"rating": 4.6,

"reviewCount": 5200,

"address": "1906 Van Ness Ave"

}

"news": [],

"featuredSnippet": null

"meta": {

"tool": "google-serp",

"creditsUsed": 5,

"requestId": "req_abc123"

}