RUruncaptain
datasets

Batch Search Datasets

Changed on

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

Searches the same query across all specified datasets simultaneously 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

  • Base URL
    https://api.captain.dev
  • URL
    https://api.captain.dev/v2/datasets/batch-search
  • Auth
    none declared

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

  • 61a9364ad042Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      the response property became required for the status

  • d07ce3783494Revision changes
    • info

      api operation id batch-search-datasets removed and replaced with datasets_batch_search_datasets