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"
ORG_ID = "your_organization_id"
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "X-Organization-ID": ORG_ID
}
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",
  "title": "Example Political Analysis",
  "author": "Staff Reporter",
  "date": "2025-01-15",
  "chars": 4250,
  "content": "The full article content in markdown format..."
}

Get a full article from a supported news dataset.

Contact your Account Executive for available datasets.

URL Path

The article URL is appended directly to the endpoint path. The URL must match the domain of the specified dataset.

Response

Returns the full article content in markdown format, along with metadata like title, author, date, and character count.

Get a full article from a supported news dataset. Contact your Account Executive for available datasets. ## URL Path The article URL is appended directly to the endpoint path. The URL must match the domain of the specified dataset. ## Response Returns the full article content in markdown format, along with metadata like title, author, date, and character count.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Path parameters

datasetstringOptional

The dataset to get articles from. Contact your Account Executive for available datasets.

urlstringRequired

Headers

X-Organization-IDstringRequired

Response

Article retrieved successfully

datasetstring

The dataset the article was retrieved from

urlstringformat: "uri"

Original article URL

titlestring

Article title

authorstring

Article author

datestring

Publication date

charsinteger

Character count of the article content

contentstring

Full article content in markdown format

errorstring

Error message if the request failed

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

503

Service Unavailable Error