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 all datasets (omit 'datasets' to search all)
response = requests.post(
    f"{BASE_URL}/v2/datasets/batch-search",
    headers=headers,
    json={"q": "artificial intelligence regulation", "limit": 10},
    timeout=30.0
)
print(json.dumps(response.json(), indent=2))

{
  "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",
      "author": "Cecilia Kang"
    },
    {
      "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, with implications for American tech firms...",
      "date": "Feb 1, 2025",
      "source": "Washington Post",
      "author": "Cat Zakrzewski"
    },
    {
      "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, raising questions about the future of oversight...",
      "date": "Jan 20, 2025",
      "source": "The Atlantic"
    }
  ],
  "total_results": 8400,
  "results_by_dataset": {
    "nytimes": [
      {
        "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"
      }
    ],
    "washpost": [
      {
        "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, with implications for American tech firms...",
        "date": "Feb 1, 2025",
        "source": "Washington Post"
      }
    ],
    "theatlantic": [
      {
        "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, raising questions about the future of oversight...",
        "date": "Jan 20, 2025",
        "source": "The Atlantic"
      }
    ]
  },
  "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.

Contact your Account Executive for available datasets.

Response

Returns results grouped by dataset source, with title, URL, snippet, author, 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. Contact your Account Executive for available datasets. ## Response Returns results grouped by dataset source, with title, URL, snippet, author, 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)

authorstringOptional

Filter results by author/byline name. Used as an AND condition with q - returns only articles matching BOTH the query topic AND the specified author. For all articles by an author regardless of topic, use a broad query like q=* with author.

Response

Batch search completed successfully

querystring

Original search query

datasets_searchedlist of strings

Datasets that were searched

resultslist of objects

All results across datasets

total_resultsinteger

Total results found

results_by_datasetmap from strings to lists of objects

Results grouped by dataset name

errorsmap from strings to strings

Any errors that occurred during search

Errors

400

Bad Request Error

401

Unauthorized Error

503

Service Unavailable Error