Quickstart

curl --request GET \
  --url "https://api.bonai.io/google-news/search?query=technology" \
  --header "api-key: YOUR_API_KEY"

{
  "metadata": {
    "id": "c1a2b3d4-e5f6-4789-8abc-def012345678",
    "total_hits": 842,
    "took_ms": 96,
    "timestamp": "2026-07-30T09:00:00Z"
  },
  "parameters": {
    "query": "technology",
    "country": "us",
    "language": "en"
  },
  "news_articles": [
    {
      "type": "article",
      "title": "Example technology headline",
      "url": "https://example.com/story",
      "date": "2026-07-30T08:00:00Z",
      "image": "https://example.com/image.jpg",
      "source": {
        "name": "Example Publishing",
        "url": "https://example.com",
        "favicon": "https://example.com/favicon.ico",
        "publication_id": "CAAq..."
      },
      "authors": ["Jane Doe"]
    }
  ]
}

curl --request GET \
  --url "https://api.bonai.io/google-news/topics?topic_id=TECHNOLOGY&country=us&language=en" \
  --header "api-key: YOUR_API_KEY"

curl --request GET \
  --url "https://api.bonai.io/google-news/frontpage?country=us&language=en" \
  --header "api-key: YOUR_API_KEY"

curl --request GET \
  --url "https://api.bonai.io/google-news/stories?story_id=STORY_ID&country=us&language=en" \
  --header "api-key: YOUR_API_KEY"