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 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 get articles from. Contact your Account Executive for available datasets.

urlstringRequired

Response

Article retrieved successfully

datasetstring

The dataset the article was retrieved from

urlstringformat: "uri"

Original article URL

titlestring or null

Article title

authorstring or null

Article author

datestring or null

Publication date

charsinteger or null

Character count of the article content

contentstring or null

Full article content in markdown format

errorstring or null

Error message if the request failed

URL Path

Response

Authentication

Path parameters

Response

Errors

URL Path

Response