Obtener el recuento de publicaciones recientes

Obtiene el recuento de Publicaciones de los últimos 7 días que coinciden con una consulta de búsqueda.

GET /2/tweets/counts/recent

Obtener el recuento de publicaciones recientes

cURL

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

200

{
  "data": [
    {
      "end": "2023-11-07T05:31:56Z",
      "start": "2023-11-07T05:31:56Z",
      "tweet_count": 123
    }
  ],
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ],
  "meta": {
    "newest_id": "<string>",
    "next_token": "<string>",
    "oldest_id": "<string>",
    "total_tweet_count": 123
  }
}

Autorizaciones

Authorization · string · header · requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de consulta

query · string · requerido

Consulta/regla/filtro para encontrar Publicaciones que coincidan. Consulte https://t.co/rulelength para identificar la longitud máxima de la consulta.

Required string length: 1 - 4096

Ejemplo:

"(from:TwitterDev OR from:TwitterAPI) has:media -is:retweet"

start_time · string<date-time>

YYYY-MM-DDTHH:mm:ssZ. La marca de tiempo UTC más antigua (de los últimos 7 días) desde la cual se devolverán las Publicaciones. La marca de tiempo tiene una granularidad de segundos y es inclusiva (es decir, 12:00:01 incluye también el primer segundo de ese minuto).

end_time · string<date-time>

AAAA-MM-DDTHH:mm:ssZ. La marca de tiempo UTC más reciente hasta la que se proporcionarán las Publicaciones. La marca de tiempo tiene granularidad de segundos y es exclusiva (es decir, 12:00:01 excluye el primer segundo de ese minuto).

since_id · string

Devuelve los resultados cuyo ID de la Publicación es mayor (es decir, más reciente) que el ID especificado. Identificador único de este Tweet. Se devuelve como cadena para evitar complicaciones con lenguajes y herramientas que no pueden manejar enteros de gran tamaño.

Pattern: ^[0-9]{1,19}$

Ejemplo:

"1346889436626259968"

until_id · string

Devuelve los resultados cuyo ID de la Publicación es menor (es decir, más antiguo) que el ID especificado. Identificador único de este Tweet. Se devuelve como cadena para evitar complicaciones con lenguajes y herramientas que no pueden manejar enteros de gran tamaño.

Pattern: ^[0-9]{1,19}$

Ejemplo:

"1346889436626259968"

next_token · string

Este parámetro se utiliza para obtener la siguiente «página» de resultados. El valor usado con el parámetro se extrae directamente de la respuesta proporcionada por la API y no se debe modificar. Un token de paginación en base36.

Minimum string length: 1

pagination_token · string

Este parámetro se utiliza para obtener la siguiente «página» de resultados. El valor usado con el parámetro se extrae directamente de la respuesta proporcionada por la API y no se debe modificar. Un token de paginación en base36.

Minimum string length: 1

granularity · enum<string> · predeterminado: hour

La granularidad del nivel de detalle en los resultados de recuentos de búsqueda.

Opciones disponibles: minute, hour, day

search_count.fields · enum<string>[]

Una lista, separada por comas, de campos de SearchCount que se mostrarán. Campos disponibles para un objeto SearchCount.

Minimum array length: 1

Opciones disponibles: end, start, tweet_count

Ejemplo:

["end", "start", "tweet_count"]

Respuesta

200

application/json

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

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

meta · object

Show child attributes