Batch Search Datasets

POST

https://host.com/v2/datasets/batch-search

Search for articles across multiple news datasets in a single request.

Searches the same query across all specified datasets simultaneously using SerpAPI with combined site: operators for efficient multi-source search.

Supported Datasets: nytimes, washpost, sfstandard, sacbee, sfchronicle, newyorker, theatlantic, sjmercury, latimes

Example:

1 POST /v2/datasets/batch-search
2 {
3     "q": "artificial intelligence regulation",
4     "datasets": ["nytimes", "washpost", "theatlantic"],
5     "limit": 20
6 }

Headers:

Authorization: Bearer {api_key}
X-Organization-ID: Organization UUID

Search for articles across multiple news datasets in a single request. Searches the same query across all specified datasets simultaneously using SerpAPI with combined `site:` operators for efficient multi-source search. **Supported Datasets:** nytimes, washpost, sfstandard, sacbee, sfchronicle, newyorker, theatlantic, sjmercury, latimes **Example:** ```json POST /v2/datasets/batch-search { "q": "artificial intelligence regulation", "datasets": ["nytimes", "washpost", "theatlantic"], "limit": 20 } ``` **Headers:** - `Authorization`: Bearer {api_key} - `X-Organization-ID`: Organization UUID

Request

This endpoint expects an object.

qstringRequired

Search query

authorstringOptional

Filter results by author/byline name. Appended as quoted phrase to search query.

datasetslist of stringsOptional

List of dataset names to search across. Defaults to all datasets if not provided.

limitintegerOptional1-100Defaults to 10

Max results per dataset

Response

Successful Response

querystring

datasets_searchedlist of strings

errorsmap from strings to strings

resultslist of objects

results_by_datasetmap from strings to lists of objects

total_resultsintegerDefaults to 0

Errors

400

Batch Search Datasets Request Bad Request Error

401

Batch Search Datasets Request Unauthorized Error

403

Batch Search Datasets Request Forbidden Error

500

Batch Search Datasets Request Internal Server Error

503

Batch Search Datasets Request Service Unavailable Error

1	import requests
2
3	url = "https://host.com/v2/datasets/batch-search"
4
5	payload = { "q": "q" }
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())

1	{
2	"query": "query",
3	"datasets_searched": [
4	"datasets_searched"
5	],
6	"errors": {
7	"key": "value"
8	},
9	"results": [
10	{
11	"title": "title",
12	"url": "url",
13	"author": "author",
14	"date": "date",
15	"snippet": "snippet",
16	"source": "source"
17	}
18	],
19	"results_by_dataset": {
20	"key": [
21	{
22	"title": "title",
23	"url": "url"
24	}
25	]
26	},
27	"total_results": 1
28	}

1	POST /v2/datasets/batch-search
2	{
3	"q": "artificial intelligence regulation",
4	"datasets": ["nytimes", "washpost", "theatlantic"],
5	"limit": 20
6	}