Make your first request

Every request to the Baalvion Intelligence API is authenticated with a bearer token tied to your account's API key. Create a free account to get a key, then filter articles by keyword, category, country, source, or sentiment.

1. Get an API key

Sign up for a free account and generate a key from the API dashboard. Free plan keys are rate limited to 100 requests per day.

2. Make a request

curl https://news.baalvion.com/v1/news?keyword=OpenAI \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Read the response

Every response returns structured intelligence, not just raw article text.

{
  "success": true,
  "data": {
    "items": [
      {
        "title": "OpenAI ships GPT Enterprise with
          agentic workflow tools",
        "source": { "name": "TechCrunch", "type": "rss" },
        "category": "AI",
        "country": "US",
        "sentiment": "positive",
        "entities": [{ "name": "OpenAI", "count": 4 }],
        "published_at": "2026-07-10T08:12:00Z"
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1
  }
}