Batch Search Datasets | Captain Docs

import requests
BASE_URL = "https://api.runcaptain.com"
API_KEY = "your_api_key"
headers = {"Authorization": f"Bearer {API_KEY}"}
response = requests.post(
    f"{BASE_URL}/v2/datasets/batch-search",
    headers=headers,
    json={"q": "BRCA1", "datasets": ["nejm"], "limit": 2},
    timeout=60.0
)
print(response.json())

{
  "query": "BRCA1",
  "datasets_searched": [
    "nejm"
  ],
  "errors": {},
  "results": [
    {
      "title": "Bevacizumab for BRCA1/2 -Mutated Triple-Negative Breast Cancer",
      "url": "https://clinician.nejm.org/nejm-jw.NA47412?show-author=true&author-id=AU1223",
      "author": null,
      "date": "06/27/2026, 07:00 PM, +0000 UTC",
      "snippet": null,
      "source": "NEJM"
    },
    {
      "title": "Adjuvant Olaparib for Patients with BRCA1 - or BRCA2 -Mutated Breast Cancer",
      "url": "https://www.nejm.org/doi/full/10.1056/NEJMoa2105215",
      "author": null,
      "date": "06/03/2021, 07:00 AM, +0000 UTC",
      "snippet": null,
      "source": "NEJM"
    }
  ],
  "results_by_dataset": {
    "nejm": [
      {
        "title": "Bevacizumab for BRCA1/2 -Mutated Triple-Negative Breast Cancer",
        "url": "https://clinician.nejm.org/nejm-jw.NA47412?show-author=true&author-id=AU1223",
        "author": null,
        "date": "06/27/2026, 07:00 PM, +0000 UTC",
        "snippet": null,
        "source": "NEJM"
      },
      {
        "title": "Adjuvant Olaparib for Patients with BRCA1 - or BRCA2 -Mutated Breast Cancer",
        "url": "https://www.nejm.org/doi/full/10.1056/NEJMoa2105215",
        "author": null,
        "date": "06/03/2021, 07:00 AM, +0000 UTC",
        "snippet": null,
        "source": "NEJM"
      }
    ]
  },
  "total_results": 2
}

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

authorstring or nullOptional

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

datasetslist of strings or nullOptional

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

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

503

Service Unavailable Error

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