Batch SERP
Schedule SERP tasks for delayed retrieval with postback and pingback support.
Below you will find a detailed description of the fields you can use for setting a task.
All POST data should be sent in JSON format (UTF-8 encoding). The task setting is done using the POST method when the array of tasks is sent in JSON format. We recommend setting up to 100 tasks at a time.
Requires authentication → provide your API key as a Bearer token in the Authorization header.
POST https://api.serphouse.com/serp/schedule
Batch SERP
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, bing or yahoo domain.You can get the list of available search engines 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 | Device can bedesktop To extract desktop resultmobile To extract mobile result |
| serp_type * | string | Serp type can beweb Get structured json result search engines web resultnews Get news result from search enginesimage Search image over search engines and get json result |
| loc * | string | Optional field if you specify loc_idWhen choose yahoo domain then field is optional You 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 | Set Google Verbatim search, Parameter value can be 0 or 1 |
| gfilter | integer | Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters. |
| page | integer | Define google/bing serp result page number. |
| num_result | integer | Define number of results you want to get per page. |
| postback_url | url | Return URL for sending task results. If you specify the Postback URL there will be no need to use Get SERP Tasks Results for obtaining results. We will send the result of a completed task by a POST request to the URL as soon as the task is completed. You can change your webhook setting from Webhook Settings Page. |
| pingback_url | url | Pingback URL is Notification URL of a completed task. When a task is completed we will notify you by GET request sent to the URL you have specified. You can change your webhook setting from Webhook Settings Page. |
| 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/schedule' \--header 'Authorization: Bearer <YOUR_API_KEY>' \--header 'Content-Type: application/json' \--data-raw '{ "data": [ { "q": "Electric Vehicles", "domain": "bing.com", "lang": "en-IN", "device": "desktop", "serp_type": "web", "loc": "Surat,Gujarat,India", "page": 1 }, { "q": "TeOlympicsa", "domain": "google.com", "lang": "en", "device": "mobile", "serp_type": "web", "loc": "Surat,Gujarat,India", "page": 1 }, { "domain": "us.yahoo.com", "lang": "lang_en", "q": "Healthy Recipes", "device": "desktop", "serp_type": "web" } ]}'Example Response
{ "status": "success", "msg": "Task(s) successfully scheduled", "results": [ { "user_id": 4281, "se": "bing", "q": "Electric Vehicles", "domain": "bing.com", "lang": "en-IN", "country_iso": "IN", "loc": "Surat,Gujarat,India", "lat": "21.17", "long": "72.83", "device": "desktop", "serp_type": "web", "verbatim": 0, "date_range": null, "gfilter": 1, "pingback_url": null, "postback_url": null, "is_scheduled": 1, "page": 1, "num_result": 10, "updated_at": "2026-08-03T09:08:04.000000Z", "created_at": "2026-08-03T09:08:04.000000Z", "id": 259423989 }, { "user_id": 4281, "se": "google", "q": "TeOlympicsa", "domain": "google.com", "lang": "en", "country_iso": "IN", "loc": "Surat,Gujarat,India", "lat": "21.17", "long": "72.83", "device": "mobile", "serp_type": "web", "verbatim": 0, "date_range": null, "gfilter": 1, "pingback_url": null, "postback_url": null, "is_scheduled": 1, "page": 1, "num_result": 10, "updated_at": "2026-08-03T09:08:04.000000Z", "created_at": "2026-08-03T09:08:04.000000Z", "id": 259423990 }, { "user_id": 4281, "se": "yahoo", "q": "Healthy Recipes", "domain": "us.yahoo.com", "lang": "lang_en", "country_iso": "IN", "loc": "Surat,Gujarat,India", "lat": "21.17", "long": "72.83", "device": "desktop", "serp_type": "web", "verbatim": 0, "date_range": null, "gfilter": 1, "pingback_url": null, "postback_url": null, "is_scheduled": 1, "page": 1, "num_result": 10, "updated_at": "2026-08-03T09:08:04.000000Z", "created_at": "2026-08-03T09:08:04.000000Z", "id": 259423991 } ]}Related Links
Last updated on
How is this guide?