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
}
response = requests.get(
    f"{BASE_URL}/v2/datasets/dataset_name/search",
    params={"q": "climate change policy", "limit": 5},
    headers=headers,
    timeout=30.0
)
print(json.dumps(response.json(), indent=2))

{
  "dataset": "dataset_name",
  "query": "climate change policy",
  "results": [
    {
      "title": "New Climate Policies Announced",
      "url": "https://www.example.com/2025/01/15/climate/new-policies",
      "snippet": "The administration unveiled a comprehensive set of climate policies...",
      "date": "2025-01-15",
      "source": "Example News"
    }
  ],
  "total_results": 5,
  "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)

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 or null

Error message if search failed

Response

Authentication

Path parameters

Headers

Query parameters

Response

Errors