Search News
curl --request GET \
--url https://api.x.com/2/news/search \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.x.com/2/news/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.x.com/2/news/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.x.com/2/news/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.x.com/2/news/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.x.com/2/news/search")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.x.com/2/news/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"rest_id": "2244994945",
"category": "<string>",
"cluster_posts_results": [
{
"post_id": "1346889436626259968"
}
],
"contexts": {
"entities": {
"events": [
"<string>"
],
"organizations": [
"<string>"
],
"people": [
"<string>"
],
"places": [
"<string>"
],
"products": [
"<string>"
]
},
"finance": {
"tickers": [
"<string>"
]
},
"sports": {
"teams": [
"<string>"
]
},
"topics": [
"<string>"
]
},
"disclaimer": "<string>",
"hook": "<string>",
"keywords": [
"<string>"
],
"last_updated_at_ms": "2025-7-14T04:35:55Z",
"name": "<string>",
"summary": "<string>"
}
],
"errors": [
{
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"status": 123
}
],
"meta": {
"result_count": 123
}
}{
"code": 123,
"message": "<string>"
}News
Search News
Retrieves a list of News stories matching the specified search query.
GET
/
2
/
news
/
search
Search News
curl --request GET \
--url https://api.x.com/2/news/search \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.x.com/2/news/search"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.x.com/2/news/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.x.com/2/news/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.x.com/2/news/search"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.x.com/2/news/search")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.x.com/2/news/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"rest_id": "2244994945",
"category": "<string>",
"cluster_posts_results": [
{
"post_id": "1346889436626259968"
}
],
"contexts": {
"entities": {
"events": [
"<string>"
],
"organizations": [
"<string>"
],
"people": [
"<string>"
],
"places": [
"<string>"
],
"products": [
"<string>"
]
},
"finance": {
"tickers": [
"<string>"
]
},
"sports": {
"teams": [
"<string>"
]
},
"topics": [
"<string>"
]
},
"disclaimer": "<string>",
"hook": "<string>",
"keywords": [
"<string>"
],
"last_updated_at_ms": "2025-7-14T04:35:55Z",
"name": "<string>",
"summary": "<string>"
}
],
"errors": [
{
"title": "<string>",
"type": "<string>",
"detail": "<string>",
"status": 123
}
],
"meta": {
"result_count": 123
}
}{
"code": 123,
"message": "<string>"
}Authorizations
BearerTokenOAuth2UserToken
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Scopes
tweet.read
View all Posts you can see, including those from protected accounts.
users.read
View any account you can see, including protected accounts.
Query Parameters
The search query.
Required string length:
1 - 2048Example:
"crypto"
The number of results to return.
Required range:
1 <= x <= 100The maximum age of the News story to search for.
Required range:
1 <= x <= 720A comma separated list of News fields to display. The fields available for a News object.
Minimum array length:
1Available options:
category, cluster_posts_results, contexts, disclaimer, hook, id, keywords, name, summary, updated_at Example:
[
"category",
"cluster_posts_results",
"contexts",
"disclaimer",
"hook",
"id",
"keywords",
"name",
"summary",
"updated_at"
]
Response
The request has succeeded.
Minimum array length:
1Show child attributes
Show child attributes
Minimum array length:
1An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
Show child attributes
Show child attributes
Show child attributes
Show child attributes