Get Entity News | Captain Docs

import requests
import json
BASE_URL = "https://api.runcaptain.com"
API_KEY = "your_api_key"
ORG_ID = "your_organization_id"
ENTITY_ID = "your_entity_id"  # Get this from /general/search
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "X-Organization-ID": ORG_ID
}
# You can also pass a domain (e.g., "openai.com") or name instead of entity_id
response = requests.get(
    f"{BASE_URL}/v2/datasets/odyssey/general/{ENTITY_ID}/news",
    headers=headers,
    timeout=30.0
)
data = response.json()
print(json.dumps(data, indent=2))

{
  "entity_id": "019cb8ac-adee-749e-a75e-a1c236f20f72",
  "news": [
    {
      "title": "OpenAI Raises $6.6B in New Funding Round",
      "url": "https://example.com/openai-funding",
      "source": "TechCrunch",
      "published_date": "2024-10-02",
      "snippet": "OpenAI has closed a $6.6 billion funding round at a $157 billion valuation, making it one of the most valuable private companies."
    }
  ],
  "total_count": 1
}

Get recent news articles and mentions for any entity. Returns article titles, URLs, sources, publication dates, and snippets. Useful for tracking announcements, funding news, and company updates.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Path parameters

entity_idstringRequired

Response

Successful response

entity_idstring

Entity identifier

newslist of objects

total_countinteger

Total number of articles

Errors

401

Unauthorized Error

404

Not Found Error

Authentication

Path parameters

Headers

Response

Errors