Passer au contenu principal
GET
/
2
/
tweets
/
counts
/
recent
Obtenir le nombre de publications récentes
curl --request GET \
  --url https://api.x.com/2/tweets/counts/recent \
  --header 'Authorization: Bearer <token>'
{
  "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

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

​
data
object[]
Minimum array length: 1
​
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).

​
meta
object