Search Dataset Articles

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 a single dataset
response = requests.get(
    f"{BASE_URL}/v2/datasets/nytimes/search",
    headers=headers,
    params={"q": "artificial intelligence", "limit": 5},
    timeout=30.0
)
print(json.dumps(response.json(), indent=2))

{
  "dataset": "nytimes",
  "query": "artificial intelligence",
  "results": [
    {
      "title": "Meta Lays Off 700 Employees, While Rewarding Top Executives",
      "url": "https://www.nytimes.com/2026/03/25/technology/meta-layoffs-ai-executives.html",
      "date": "03/25/2026, 07:22 PM, +0000 UTC",
      "source": "New York Times",
      "author": "Eli Tan"
    },
    {
      "title": "People Loved the Dot-Com Boom. The A.I. Boom, Not So Much.",
      "url": "https://www.nytimes.com/2026/03/15/technology/ai-boom-dot-com.html",
      "date": "03/15/2026, 08:00 AM, +0000 UTC",
      "source": "New York Times",
      "author": "David Streitfeld"
    }
  ],
  "total_results": 100,
  "limit": 5
}

Search for articles within a news dataset.

Contact your Account Executive for available datasets.

Response

Returns a list of search results with title, URL, snippet, and date.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Path parameters

datasetstringOptional

The dataset to search. Contact your Account Executive for available datasets.

Headers

X-Organization-IDstringRequired

Query parameters

qstringRequired

Search query

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

Search completed successfully

datasetstring

The dataset that was searched

querystring

Original search query

resultslist of objects

List of search results

total_resultsinteger

Total number of results available

limitinteger

Maximum results requested

errorstring

Error message if search failed

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error