Endpoint for retrieving news stories — 2 operation(s) in the X-published contract.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/x:x-news-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
description: X API v2 core endpoints
version: '2.168'
title: X API v2 News API
termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
contact:
name: X Developers
url: https://developer.x.com/
license:
name: X Developer Agreement and Policy
url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
- description: X API
url: https://api.x.com
tags:
- name: News
description: Endpoint for retrieving news stories
externalDocs:
description: Find out more
url: https://developer.x.com/
paths:
/2/news/search:
get:
security:
- OAuth2UserToken:
- tweet.read
- users.read
- UserToken: []
- BearerToken: []
tags:
- News
summary: Search News
operationId: searchNews
parameters:
- name: query
in: query
required: true
schema:
type: string
minLength: 1
maxLength: 2048
style: form
- name: max_results
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
format: int32
default: 10
style: form
- name: max_age_hours
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 720
format: int32
default: 168
style: form
- $ref: '#/components/parameters/NewsFieldsParameter'
responses:
'200':
description: The request has succeeded.
content:
application/json:
schema:
$ref: '#/components/schemas/SearchNewsResponse'
default:
description: The request has failed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
/2/news/{id}:
get:
security:
- OAuth2UserToken:
- tweet.read
- users.read
- UserToken: []
- BearerToken: []
tags:
- News
summary: Get news stories by ID
description: Retrieves news story by its ID.
externalDocs:
url: https://docs.x.com/x-api/news/introduction
operationId: getNews
parameters:
- name: id
in: path
required: true
schema:
type: string
pattern: ^[0-9]{1,19}$
style: simple
- $ref: '#/components/parameters/NewsFieldsParameter'
responses:
'200':
description: The request has succeeded.
content:
application/json:
schema:
$ref: '#/components/schemas/GetNewsResponse'
default:
description: The request has failed.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
components:
schemas:
GetNewsResponse:
type: object
properties:
data:
$ref: '#/components/schemas/News'
errors:
type: array
items:
$ref: '#/components/schemas/Problem'
NewsClusterPostsResults:
type: array
items:
type: object
description: A Post belonging to this news story's cluster.
required:
- post_id
properties:
post_id:
type: string
description: Unique identifier of the Post.
ResourceNotFoundProblem:
type: object
required:
- type
- title
- detail
- resource_type
properties:
detail:
type: string
parameter:
type: string
resource_id:
type: string
resource_type:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/resource-not-found
value:
type: string
News:
type: object
properties:
category:
type: string
cluster_posts_results:
$ref: '#/components/schemas/NewsClusterPostsResults'
contexts:
type: object
disclaimer:
type: string
hook:
type: string
id:
type: string
keywords:
type: object
name:
type: string
summary:
type: string
updated_at:
type: string
FieldHydrationFailureProblem:
type: object
required:
- type
- title
- detail
- field
properties:
detail:
type: string
field:
type: string
resource_type:
type: string
section:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/field-hydration-failure
NotAuthorizedForFieldProblem:
type: object
required:
- type
- title
- detail
- field
properties:
detail:
type: string
field:
type: string
parameter:
type: string
resource_id:
type: string
resource_type:
type: string
section:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/not-authorized-for-field
value:
type: string
SearchNewsResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/News'
errors:
type: array
items:
$ref: '#/components/schemas/Problem'
meta:
type: object
properties:
result_count:
type: integer
description: Number of items in the data array.
format: int32
Error:
type: object
required:
- code
- message
properties:
code:
type: integer
format: int32
message:
type: string
InvalidRequestProblem:
type: object
required:
- type
- title
- detail
properties:
detail:
type: string
parameter:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/invalid-request
value:
type: string
Problem:
oneOf:
- $ref: '#/components/schemas/ResourceNotFoundProblem'
- $ref: '#/components/schemas/InvalidRequestProblem'
- $ref: '#/components/schemas/NotAuthorizedForResourceProblem'
- $ref: '#/components/schemas/NotAuthorizedForFieldProblem'
- $ref: '#/components/schemas/FieldUnauthorizedProblem'
- $ref: '#/components/schemas/FieldHydrationFailureProblem'
- $ref: '#/components/schemas/ResourceUnavailableProblem'
- $ref: '#/components/schemas/DisallowedResourceProblem'
- $ref: '#/components/schemas/InternalErrorProblem'
discriminator:
propertyName: type
mapping:
https://api.x.com/2/problems/disallowed-resource: '#/components/schemas/DisallowedResourceProblem'
https://api.x.com/2/problems/field-hydration-failure: '#/components/schemas/FieldHydrationFailureProblem'
https://api.x.com/2/problems/field-unauthorized: '#/components/schemas/FieldUnauthorizedProblem'
https://api.x.com/2/problems/internal-error: '#/components/schemas/InternalErrorProblem'
https://api.x.com/2/problems/invalid-request: '#/components/schemas/InvalidRequestProblem'
https://api.x.com/2/problems/not-authorized-for-field: '#/components/schemas/NotAuthorizedForFieldProblem'
https://api.x.com/2/problems/not-authorized-for-resource: '#/components/schemas/NotAuthorizedForResourceProblem'
https://api.x.com/2/problems/resource-not-found: '#/components/schemas/ResourceNotFoundProblem'
https://api.x.com/2/problems/resource-unavailable: '#/components/schemas/ResourceUnavailableProblem'
FieldUnauthorizedProblem:
type: object
required:
- type
- title
- detail
- field
properties:
detail:
type: string
field:
type: string
resource_type:
type: string
section:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/field-unauthorized
DisallowedResourceProblem:
type: object
required:
- type
- title
- detail
properties:
detail:
type: string
resource_id:
type: string
resource_type:
type: string
section:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/disallowed-resource
ResourceUnavailableProblem:
type: object
required:
- type
- title
- detail
- resource_type
properties:
detail:
type: string
resource_id:
type: string
resource_type:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/resource-unavailable
InternalErrorProblem:
type: object
required:
- type
- title
- detail
properties:
detail:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/internal-error
NotAuthorizedForResourceProblem:
type: object
required:
- type
- title
- detail
- resource_type
properties:
detail:
type: string
parameter:
type: string
resource_id:
type: string
resource_type:
type: string
section:
type: string
status:
type: integer
title:
type: string
type:
type: string
enum:
- https://api.x.com/2/problems/not-authorized-for-resource
value:
type: string
parameters:
NewsFieldsParameter:
name: news.fields
in: query
description: A comma separated list of News fields to display.
required: false
schema:
type: array
description: The fields available for a News object.
minItems: 1
uniqueItems: true
items:
type: string
enum:
- category
- cluster_posts_results
- contexts
- contexts
- contexts
- contexts
- disclaimer
- hook
- id
- keywords
- name
- summary
- updated_at
explode: false
style: form
securitySchemes:
BearerToken:
type: http
scheme: bearer
OAuth2UserToken:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://api.x.com/2/oauth2/authorize
tokenUrl: https://api.x.com/2/oauth2/token
scopes:
block.read: View accounts you have blocked.
block.write: Block and unblock accounts on your behalf.
bookmark.read: Read your bookmarked Posts.
bookmark.write: Create and delete your bookmarks.
broadcast.read: View your live broadcasts and their chat.
broadcast.write: Manage your live broadcasts and send chat messages on your behalf.
developer.read: View your developer accounts, apps, and settings.
developer.write: Create and manage your X Developer Platform account.
dm.read: Read all your Direct Messages.
dm.write: Send and manage your Direct Messages.
follows.read: View accounts you follow and accounts following you.
follows.write: Follow and unfollow accounts on your behalf.
like.read: View Posts you have liked and likes you can see.
like.write: Like and unlike Posts on your behalf.
list.read: View Lists, members, and followers of Lists you created or are a member of, including private Lists.
list.write: Create and manage Lists on your behalf.
media.write: Upload media, such as photos and videos, on your behalf.
mute.read: View accounts you have muted.
mute.write: Mute and unmute accounts on your behalf.
offline.access: Request a refresh token for the app.
space.read: View all Spaces you have access to.
timeline.read: View all Custom Timelines you can see.
tweet.moderate.write: Hide and unhide replies to your posts.
tweet.read: View all posts you can see, including those from protected accounts.
tweet.write: Create and repost on your behalf.
users.read: View any account you can see, including protected accounts.
UserToken:
type: http
scheme: OAuth