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 authentication of the form Bearer <token>, where token is your auth token.

X-Organization-IDstring

API Key authentication via header

Path parameters

datasetstringOptional

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

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

Response

Errors