datasets

Batch Search Datasets

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:

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
post/v2/datasets/batch-search

Request body

authorstring nullable

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

datasetsstring[] nullable

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

limitinteger

Max results per dataset

qstring required

Search query

Response

Successful Response

datasets_searchedstring[]
errorsobject
querystring required
results_by_datasetobject
total_resultsinteger

Changes

No recorded changes to this endpoint across all 1 revision of this API.