Headline

Description: Displays prominent news headlines related to the search query.

API Response Structure:

{
  "headlines": [
    {
      "title": "Headline Text",
      "source": {
        "name": "News Organization",
        "logo": "https://example.com/logo.png",
        "verified": true,
        "category": "Mainstream/Local/Industry"
      },
      "article": {
        "url": "https://example.com/article",
        "published": "2023-08-15T10:00:00Z",
        "updated": "2023-08-15T11:00:00Z",
        "summary": "Article summary...",
        "coverage": {
          "depth": "Breaking/Developing/Analysis",
          "perspective": "Neutral/Opinion"
        }
      },
      "media": {
        "featured": "https://example.com/image.jpg",
        "gallery": ["url1", "url2"],
        "hasVideo": true
      },
      "related": [
        {
          "headline": "Related story",
          "url": "https://example.com/related"
        }
      ]
    }
  ],
  "trending": {
    "keywords": ["keyword1", "keyword2"],
    "relatedTopics": ["topic1", "topic2"]
  },
  "type": "headline"
}

Fields:

  • headlines (array): News headlines

    • title (string): Headline text

    • source (object): Publisher info

    • article (object): Article details

    • media (object): Visual content

    • related (array): Related stories

  • trending (object): Trending topics

  • type (string): Always "headline"