Google Batch SERP (Top 100 Results)
Schedule multi-page Google SERP searches with credit refund for unused pages.
Requires authentication → provide your API key as a Bearer token in the Authorization header.
POST https://api.serphouse.com/serp/google_advanced_scheduled
Headers
| Name | Type | Description |
|---|---|---|
| Authorization * | String | Bearer <YOUR_API_KEY> |
| Content-Type * | String | application/json |
Request Body
| Name | Type | Description |
|---|---|---|
| q * | string | Search phrase that you want to search |
| domain * | string | Choose google domain. You can retrieve the list of supported Google domains by making a separate request to the Domains List |
| lang * | string | You can set language for e.g. en for english fr for french.Get the list of available languages by making a separate request to the Languages List |
| device * | string | desktop To extract desktop result mobile To extract mobile result |
| loc * | string | Optional field if you specify loc_idYou must choose one of the fields: loc_id or locYou can receive the list of available locations of search engines with their loc_id by making a separate request to the Locations List |
| loc_id * | integer | Optional field if you specify locYou must choose one of the fields: loc_id or locYou can receive the list of available locations of search engines with their loc_id by making a separate request to the Locations List |
| verbatim | integer | Google Verbatim (0 or 1) |
| gfilter | integer | Filter on/off (1 or 0) |
| postback_url | url | POST results to this URL when complete |
| pingback_url | url | GET notification URL when complete |
| max_pages | integer | Pages to return (1–10, default 10) |
| date_range | String | Sometimes you may want to only find information published during a specific time frame. To limit Google results by date Parameter values can be comma separated date range YYYY-MM-DD,YYYY-MM-DD ORh Past hourd Past 24 hoursw Past weekm Past monthy Past year |
Example Request
curl --location --request POST 'https://api.serphouse.com/serp/google_advanced_scheduled' \--header 'Authorization: Bearer <YOUR_API_KEY>' \--header 'Content-Type: application/json' \--data-raw '{ "data": [ { "q": "donlad trump", "domain": "google.com", "lang": "en", "device": "desktop", "loc": "London,England,United Kingdom", "max_pages": 10 }, { "q": "Tesla", "domain": "google.com", "lang": "ru", "device": "mobile", "loc": "Russia", "max_pages": 4 }, { "q": "Artificial Intelligence", "domain": "google.com", "lang": "en", "device": "desktop", "loc": "Alba,Texas,United States", "max_pages": 7 } ]}'Example Response
{ "status": "success", "msg": "Task(s) successfully scheduled", "results": [ { "user_id": 4281, "se": "google_advanced", "q": "donlad trump", "domain": "google.com", "lang": "en", "country_iso": "GB", "loc": "London,England,United Kingdom", "lat": "51.51", "long": "-0.13", "device": "desktop", "verbatim": "0", "date_range": null, "gfilter": "1", "pingback_url": null, "postback_url": null, "is_scheduled": 1, "page": 1, "num_result": 100, "updated_at": "2026-08-03T06:25:18.000000Z", "created_at": "2026-08-03T06:25:18.000000Z", "id": 259317627, "max_pages": 10 }, { "user_id": 4281, "se": "google_advanced", "q": "Tesla", "domain": "google.com", "lang": "ru", "country_iso": "RU", "loc": "Russia", "lat": "61.52", "long": "105.32", "device": "mobile", "verbatim": "0", "date_range": null, "gfilter": "1", "pingback_url": null, "postback_url": null, "is_scheduled": 1, "page": 1, "num_result": 40, "updated_at": "2026-08-03T06:25:18.000000Z", "created_at": "2026-08-03T06:25:18.000000Z", "id": 259317629, "max_pages": 4 }, { "user_id": 4281, "se": "google_advanced", "q": "Artificial Intelligence", "domain": "google.com", "lang": "en", "country_iso": "US", "loc": "Alba,Texas,United States", "lat": "32.79", "long": "-95.63", "device": "desktop", "verbatim": "0", "date_range": null, "gfilter": "1", "pingback_url": null, "postback_url": null, "is_scheduled": 1, "page": 1, "num_result": 70, "updated_at": "2026-08-03T06:25:18.000000Z", "created_at": "2026-08-03T06:25:18.000000Z", "id": 259317630, "max_pages": 7 } ]}Related Links
Last updated on
How is this guide?