Buscar noticias

curl --request GET \
  --url https://api.x.com/2/news/search \
  --header 'Authorization: Bearer <token>'

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))

}

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>"
}

GET

news

Buscar noticias

curl --request GET \
  --url https://api.x.com/2/news/search \
  --header 'Authorization: Bearer <token>'

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))

}

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>"
}

Autorizaciones

Authorization

string

header

requerido

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.

Parámetros de consulta

query

string

requerido

La consulta de búsqueda.

Required string length: 1 - 2048

Ejemplo:

"crypto"

max_results

integer<int32>

predeterminado:10

La cantidad de resultados que se devolverán.

Rango requerido: 1 <= x <= 100

max_age_hours

integer<int32>

predeterminado:168

La antigüedad máxima de las noticias que se van a buscar.

Rango requerido: 1 <= x <= 720

news.fields

enum<string>[]

Una lista de campos de News, separados por comas, que se mostrarán. Los campos disponibles para un objeto News.

Minimum array length: 1

Opciones disponibles:

category,

cluster_posts_results,

contexts,

disclaimer,

hook,

id,

keywords,

name,

summary,

updated_at

Ejemplo:

[
  "category",
  "cluster_posts_results",
  "contexts",
  "disclaimer",
  "hook",
  "id",
  "keywords",
  "name",
  "summary",
  "updated_at"
]

Respuesta

La solicitud se ha completado correctamente.

data

object[]

Minimum array length: 1

Show child attributes

errors

object[]

Minimum array length: 1

Un objeto HTTP Problem Details, tal como se define en el IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).

Show child attributes

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Buscar noticias

Autorizaciones

Scopes

Parámetros de consulta

Respuesta