Batch Search Articles | Captain Docs

import requests
import json
BASE_URL = "https://api.runcaptain.com"
API_KEY = "your_api_key"
ORG_ID = "your_organization_id"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "X-Organization-ID": ORG_ID
}
# Search across multiple news sources at once
# Omit 'datasets' to search all available sources
response = requests.post(
    f"{BASE_URL}/v2/datasets/batch-search",
    headers=headers,
    json={
        "q": "artificial intelligence regulation",
        "datasets": ["nytimes", "washpost", "theatlantic"],
        "limit": 10
    },
    timeout=30.0
)
data = response.json()
print(f"Found {data['total_results']} total results")
for source, articles in data.get("results_by_dataset", {}).items():
    print(f"\n{source}: {len(articles)} articles")
    for a in articles:
        print(f"  - {a['title']}")

{
  "query": "artificial intelligence regulation",
  "datasets_searched": [
    "nytimes",
    "washpost",
    "theatlantic"
  ],
  "results": [
    {
      "title": "Congress Moves to Regulate A.I., but Faces Industry Pushback",
      "url": "https://www.nytimes.com/2025/03/15/technology/ai-regulation-congress.html",
      "snippet": "Lawmakers are debating sweeping new rules for artificial intelligence companies amid growing concerns about safety...",
      "date": "Mar 15, 2025",
      "source": "New York Times"
    },
    {
      "title": "The E.U.'s AI Act Takes Effect, Setting a Global Standard",
      "url": "https://www.washingtonpost.com/technology/2025/02/01/eu-ai-act-enforcement/",
      "snippet": "The European Union's landmark artificial intelligence regulation begins enforcement...",
      "date": "Feb 1, 2025",
      "source": "Washington Post"
    },
    {
      "title": "Why AI Regulation Is Harder Than Anyone Expected",
      "url": "https://www.theatlantic.com/technology/archive/2025/01/ai-regulation-challenges/",
      "snippet": "The rapid pace of AI development has outstripped regulators' ability to keep up...",
      "date": "Jan 20, 2025",
      "source": "The Atlantic"
    }
  ],
  "total_results": 8400,
  "results_by_dataset": {},
  "errors": {}
}

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

Searches the same query across all specified datasets simultaneously. If no datasets are specified, searches all available datasets.

Supported Datasets

nytimes - New York Times
washpost - Washington Post
sfstandard - SF Standard
sacbee - Sacramento Bee
sfchronicle - San Francisco Chronicle
newyorker - The New Yorker
theatlantic - The Atlantic
sjmercury - San Jose Mercury News
latimes - Los Angeles Times

Response

Returns results grouped by dataset source, with title, URL, snippet, and date for each article.

Search for articles across multiple news datasets in a single request. Searches the same query across all specified datasets simultaneously. If no datasets are specified, searches all available datasets. ## Supported Datasets - `nytimes` - New York Times - `washpost` - Washington Post - `sfstandard` - SF Standard - `sacbee` - Sacramento Bee - `sfchronicle` - San Francisco Chronicle - `newyorker` - The New Yorker - `theatlantic` - The Atlantic - `sjmercury` - San Jose Mercury News - `latimes` - Los Angeles Times ## Response Returns results grouped by dataset source, with title, URL, snippet, and date for each article.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Headers

X-Organization-IDstringRequired

Request

This endpoint expects an object.

qstringRequired

Search query

datasetslist of stringsOptional

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

limitintegerOptional1-100Defaults to 10

Maximum number of results to return (default: 10, max: 100)

Response

Batch search completed successfully

querystring or null

Original search query

datasets_searchedlist of strings or null

Datasets that were searched

resultslist of objects or null

All results across datasets

total_resultsinteger or null

Total results found

results_by_datasetmap from strings to lists of objects or null

Results grouped by dataset name

errorsmap from strings to strings or null

Any errors that occurred during search

Supported Datasets

Response

Authentication

Headers

Request

Response

Errors

Supported Datasets

Response