Obtenir le nombre de publications récentes

Récupère le nombre de Publications correspondant à une requête de recherche sur les 7 derniers jours.

GET /2/tweets/counts/recent

Obtenir le nombre de publications récentes

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

Autorisations

Authorization · string · header · requis

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

Paramètres de requête

query · string · requis

Une requête, règle ou variable de filtrage permettant de faire correspondre des Publications. Reportez-vous à https://t.co/rulelength pour identifier la longueur maximale de requête.

Required string length: 1 - 4096

Exemple:

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

start_time · string<date-time>

YYYY-MM-DDTHH:mm:ssZ. Horodatage UTC le plus ancien (parmi les 7 derniers jours) à partir duquel les Publications seront renvoyées. L’horodatage est exprimé avec une granularité à la seconde et est inclusif (c’est‑à‑dire qu’une valeur de 12:00:01 inclut également la première seconde de la minute).

end_time · string<date-time>

YYYY-MM-DDTHH:mm:ssZ. Horodatage UTC le plus récent jusqu’auquel les Publications seront renvoyées. L’horodatage est précis à la seconde et la borne est exclusive (c.-à-d. que 12:00:01 exclut la première seconde de la minute).

since_id · string

Renvoie les résultats dont l’id de Publication est supérieur à l’id spécifié (c’est-à-dire plus récents). Identifiant unique de ce Tweet. Il est renvoyé sous forme de chaîne de caractères afin d’éviter les complications avec les langages et outils qui ne gèrent pas les entiers de très grande taille.

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

Exemple:

"1346889436626259968"

until_id · string

Renvoie les résultats dont l’id de Publication est inférieur à l’id spécifié (c’est-à-dire plus anciens). Identifiant unique de ce Tweet. Il est renvoyé sous forme de chaîne de caractères afin d’éviter les complications avec les langages et outils qui ne gèrent pas les entiers de très grande taille.

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

Exemple:

"1346889436626259968"

next_token · string

Ce paramètre est utilisé pour récupérer la « page » suivante de résultats. La valeur fournie à ce paramètre est extraite directement de la réponse renvoyée par l’API et ne doit pas être modifiée. Un jeton de pagination au format base36.

Minimum string length: 1

pagination_token · string

Ce paramètre est utilisé pour récupérer la « page » suivante de résultats. La valeur fournie à ce paramètre est extraite directement de la réponse renvoyée par l’API et ne doit pas être modifiée. Un jeton de pagination au format base36.

Minimum string length: 1

granularity · enum<string> · défaut: hour

La granularité à appliquer aux résultats du comptage de recherche.

Options disponibles: minute, hour, day

search_count.fields · enum<string>[]

Une liste de champs SearchCount, séparés par des virgules, à afficher. Champs disponibles pour un objet SearchCount.

Minimum array length: 1

Options disponibles: end, start, tweet_count

Exemple:

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

Réponse

200

application/json

La requête s’est terminée avec succès.

data · object[]

Minimum array length: 1

Show child attributes

errors · object[]

Minimum array length: 1

Un objet HTTP Problem Details, tel que défini dans la RFC IETF 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