Get Dataset Article | Captain Docs

import requests
import json
from urllib.parse import quote
BASE_URL = "https://api.runcaptain.com"
API_KEY = "your_api_key"
headers = {
    "Authorization": f"Bearer {API_KEY}",
}
article_url = "https://www.example.com/2025/01/15/politics/example-article"
response = requests.get(
    f"{BASE_URL}/v2/datasets/dataset_name/{quote(article_url, safe='')}",
    headers=headers,
    timeout=30.0
)
if response.status_code == 200:
    article = response.json()
    print(f"Title: {article['title']}")
    print(f"Author: {article['author']}")
    print(f"Content: {article['content'][:500]}...")

{
  "dataset": "dataset_name",
  "url": "https://www.example.com/2025/01/15/politics/example-article",
  "author": "Staff Reporter",
  "chars": 4250,
  "content": "The full article content in markdown format...",
  "date": "2025-01-15",
  "title": "Example Political Analysis"
}

Get a full article from a supported news dataset.

Contact your Account Executive for available datasets.

Headers:

Authorization: Bearer {api_key} - Captain API key for authentication
X-Organization-ID: Organization UUID

URL Path:

dataset: The dataset name
url: Full article URL appended to the path

Returns: Article data including title, author, date, and full content in markdown format.

Example:

GET /v2/datasets/latimes/https://www.latimes.com/example/news_example.html

Get a full article from a supported news dataset. Contact your Account Executive for available datasets. **Headers:** - `Authorization`: Bearer {api_key} - Captain API key for authentication - `X-Organization-ID`: Organization UUID **URL Path:** - `dataset`: The dataset name - `url`: Full article URL appended to the path **Returns:** Article data including title, author, date, and full content in markdown format. **Example:** ``` GET /v2/datasets/latimes/https://www.latimes.com/example/news_example.html ```

Path parameters

datasetstringRequired

The news dataset to get articles from

urlstringRequired

Full URL of the article to get (URL-encoded)

Response

Successful Response

datasetstring

urlstring

authorstring or null

charsinteger or null

contentstring or null

Full article content in markdown format

datestring or null

errorstring or null

Error message if request failed

titlestring or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

503

Service Unavailable Error