> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-bdd2bb9c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Use the X news lookup endpoint to fetch breaking headlines, story summaries, contexts, tickers, and clustered Post results with bearer token authentication.

The news lookup endpoint allows developers to get news and headlines breaking on X.

This endpoint supports app-auth and user-auth authentication for OAuth1 and OAuth2 PKCE.

## Getting started

To use the endpoint, you need a [bearer token](/fundamentals/authentication/oauth-2-0/application-only) from the [Developer Console](https://developer.x.com/en/portal/dashboard).

Once you have the bearer token, you can call the news API as shown below:

```bash theme={null}
curl 'https://api.x.com/2/news/1989418137272422538?news.fields=contexts,cluster_posts_results' --header 'Authorization: Bearer XXXXX'
```

If the request is successful, you should see the JSON response as shown below:

```json theme={null}
{
  "data":{
    "category":"News",
    "name":"Nebius Group Stock Plunges 30% Despite Q3 Revenue Surge and Meta Deal",
    "summary":"Nebius Group announced third-quarter revenue of $214 million, a fourfold increase year-over-year, alongside a $3 billion five-year GPU cloud services contract with Meta Platforms on November 11, 2025. Despite these positives, shares fell over 30% to $83.58 by November 14, driven by AI sector cooling and a $119.6 million net loss. Analysts hold a strong Buy rating with an average price target of $139.67, while X users see the dip as a buying opportunity.",
    "hook":"Nebius Group's shares cratered 30% after blockbuster Q3 earnings and a $3 billion Meta deal—yet analysts and investors are calling it a golden buying chance amid AI hype.",
    "contexts":{
      "sports":{
        "teams":[]
      },
      "entities":{
        "events":[],
        "organizations":[
          "Goldman Sachs",
          "Nebius Group N.V."
        ],
        "people":[],
        "places":[],
        "products":[]
      },
      "topics":[
        "Stocks"
      ],
      "finance":{
        "tickers":[
          "NBIS"
        ]
      }
    },
    "cluster_posts_results":[
      {
        "post_id":"1989409257394245835"
      },
      {
        "post_id":"1989410019562197162"
      },
      {
        "post_id":"1989413132993999177"
      },
      {
        "post_id":"1989411147179610400"
      },
      {
        "post_id":"1989409829937656067"
      },
      {
        "post_id":"1989415596249985296"
      },
      {
        "post_id":"1989415537781477721"
      },
      {
        "post_id":"1989413002739691628"
      },
      {
        "post_id":"1989414454644363445"
      },
      {
        "post_id":"1989411489988710860"
      }
    ],
    "disclaimer":"This story is a summary of posts on X and may evolve over time. Grok can make mistakes, verify its outputs.",
    "last_updated_at_ms":"2025-11-17T16:21:41.000Z",
    "id":"1989418137272422538"
  }
}
```