Lead Generation

Google Search Results

Organic Google search results for a set of queries, as business-website leads.

google-searchgoogleserplead-generationsearchdiscovery

0 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/google-search/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/google-search/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "queries": [        "plumbers in austin tx"      ],      "maxPages": 3,      "startPage": 1,      "country": "us"    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

queries
string[]
Search queries
One walk per query. Operators work here — `site:`, `inurl:`, quoted phrases.
Default
["plumbers in austin tx"]
Example
plumbers in austin tx
maxPages
number
Pages per query
Google rarely serves anything useful past the third page, and each page is another chance to be rate limited.
Default
3
Range
1 to 20
startPage
number
First page
Default
1
Range
1 to 100
country
string
Country (gl)
Results are country-specific. Recorded on every row, because the same query in two countries is two datasets.
Default
us
Example
us
language
string
Language (hl)
Default
en
Example
en
siteFilter
string
Restrict to site
Adds `site:` to every query.
Default
none
Example
yelp.com

Advanced

extraOperators
string
Extra operators
Appended to every query verbatim.
Default
none
Example
-inurl:facebook.com "contact us"
resultsPerPage
number
Results per page (num)
Google treats large values as a hint, not an instruction, and a high one attracts rate limiting.
Default
10
Range
1 to 100
domain
string
Google domain
Default
www.google.com
Example
www.google.com
impersonate
enum
Browser impersonation
Neither profile got results from google.com in September 2026; both got the JavaScript shell. Kept switchable because that is the sort of thing that changes.
Default
chrome
Allowed values
chrome
firefox
requestDelayMs
number
Delay between requests (ms)
Lowering this is the fastest way to earn a /sorry/ page for the whole proxy.
Default
5000
Range
0 to 120000
maxResults
number
Max results per run
Default
500
Range
1 to 10000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "queries": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Search queries",      "description": "One walk per query. Operators work here — `site:`, `inurl:`, quoted phrases.",      "default": [        "plumbers in austin tx"      ],      "examples": [        "plumbers in austin tx"      ]    },    "maxPages": {      "type": "number",      "minimum": 1,      "maximum": 20,      "title": "Pages per query",      "description": "Google rarely serves anything useful past the third page, and each page is another chance to be rate limited.",      "default": 3    },    "startPage": {      "type": "number",      "minimum": 1,      "maximum": 100,      "title": "First page",      "default": 1    },    "country": {      "type": "string",      "maxLength": 2000,      "title": "Country (gl)",      "description": "Results are country-specific. Recorded on every row, because the same query in two countries is two datasets.",      "default": "us",      "examples": [        "us"      ]    },    "language": {      "type": "string",      "maxLength": 2000,      "title": "Language (hl)",      "default": "en",      "examples": [        "en"      ]    },    "siteFilter": {      "type": "string",      "maxLength": 2000,      "title": "Restrict to site",      "description": "Adds `site:` to every query.",      "examples": [        "yelp.com"      ]    },    "extraOperators": {      "type": "string",      "maxLength": 2000,      "title": "Extra operators",      "description": "Appended to every query verbatim.",      "examples": [        "-inurl:facebook.com \"contact us\""      ]    },    "resultsPerPage": {      "type": "number",      "minimum": 1,      "maximum": 100,      "title": "Results per page (num)",      "description": "Google treats large values as a hint, not an instruction, and a high one attracts rate limiting.",      "default": 10    },    "domain": {      "type": "string",      "maxLength": 2000,      "title": "Google domain",      "default": "www.google.com",      "examples": [        "www.google.com"      ]    },    "impersonate": {      "type": "string",      "enum": [        "chrome",        "firefox"      ],      "title": "Browser impersonation",      "description": "Neither profile got results from google.com in September 2026; both got the JavaScript shell. Kept switchable because that is the sort of thing that changes.",      "default": "chrome"    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 120000,      "title": "Delay between requests (ms)",      "description": "Lowering this is the fastest way to earn a /sorry/ page for the whole proxy.",      "default": 5000    },    "maxResults": {      "type": "number",      "minimum": 1,      "maximum": 10000,      "title": "Max results per run",      "default": 500    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/google-search/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "queries": [        "plumbers in austin tx"      ],      "maxPages": 3,      "startPage": 1,      "country": "us"    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

No rows collected yet, so no fields have been observed. Run the scraper once and they will appear here.