> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Champs
> Demander des champs de données spécifiques dans les réponses de l’API
La X API v2 renvoie par défaut un volume minimal de données. Utilisez les paramètres **`fields`** pour demander des données supplémentaires pour chaque type d’objet.
***
## Fonctionnement des champs
Par défaut, une recherche de publication renvoie uniquement `id`, `text` et `edit_history_tweet_ids`. Pour obtenir davantage de données, ajoutez des paramètres de champs à votre requête :
```bash theme={null}
# Réponse par défaut - champs minimaux
curl "https://api.x.com/2/tweets/1234567890" \
-H "Authorization: Bearer $TOKEN"
# With additional fields
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=created_at,public_metrics,author_id" \
-H "Authorization: Bearer $TOKEN"
```
***
## Paramètres de champs disponibles
Chaque type d’objet a son propre paramètre de champs :
| Objet | Paramètre | Documentation |
| :------------------ | :------------- | :-------------------------------------------------------------------- |
| Publication (Tweet) | `tweet.fields` | [Champs de publication](/fr/x-api/fundamentals/data-dictionary#tweet) |
| Utilisateur | `user.fields` | [Champs d’utilisateur](/fr/x-api/fundamentals/data-dictionary#user) |
| Média | `media.fields` | [Champs de média](/fr/x-api/fundamentals/data-dictionary#media) |
| Sondage | `poll.fields` | [Champs de sondage](/fr/x-api/fundamentals/data-dictionary#poll) |
| Lieu | `place.fields` | [Champs de lieu](/fr/x-api/fundamentals/data-dictionary#place) |
***
## Exemple : champs de Publication
Demandez des champs spécifiques de Publication avec `tweet.fields` :
```bash theme={null}
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=created_at,public_metrics,lang" \
-H "Authorization: Bearer $TOKEN"
```
Réponse :
```json theme={null}
{
"data": {
"id": "1234567890",
"text": "Hello world!",
"edit_history_tweet_ids": ["1234567890"],
"created_at": "2024-01-15T12:00:00.000Z",
"lang": "en",
"public_metrics": {
"retweet_count": 10,
"reply_count": 5,
"like_count": 100,
"quote_count": 2
}
}
}
```
***
## Exemple : champs utilisateur
Demandez des champs utilisateur spécifiques à l’aide de `user.fields` :
```bash theme={null}
curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
-H "Authorization: Bearer $TOKEN"
```
Réponse :
```json theme={null}
{
"data": {
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers",
"created_at": "2013-12-14T04:35:55.000Z",
"description": "The voice of the X Developer Platform",
"public_metrics": {
"followers_count": 570842,
"following_count": 2048,
"tweet_count": 14052,
"listed_count": 1672
}
}
}
```
***
## Champs pour les objets associés
Pour obtenir les champs des objets associés (comme l’auteur d’une publication), vous avez besoin de deux choses :
1. Une **expansion** pour inclure l’objet associé
2. Le **paramètre fields** pour ce type d’objet
```bash theme={null}
# Récupérer une publication avec les détails de l'auteur
curl "https://api.x.com/2/tweets/1234567890?expansions=author_id&user.fields=description,public_metrics" \
-H "Authorization: Bearer $TOKEN"
```
Réponse :
```json theme={null}
{
"data": {
"id": "1234567890",
"text": "Hello world!",
"author_id": "2244994945"
},
"includes": {
"users": [{
"id": "2244994945",
"name": "X Developers",
"username": "xdevelopers",
"description": "The voice of the X Developer Platform",
"public_metrics": {
"followers_count": 570842,
"following_count": 2048
}
}]
}
}
```
[En savoir plus sur Expansions →](/fr/x-api/fundamentals/expansions)
***
## Combinaisons de champs courantes
```
tweet.fields=created_at,public_metrics,possibly_sensitive
```
```
user.fields=created_at,description,location,public_metrics,verified
```
```
tweet.fields=created_at,author_id,conversation_id,in_reply_to_user_id,referenced_tweets
expansions=author_id,referenced_tweets.id
user.fields=username,name
```
```
tweet.fields=attachments
expansions=attachments.media_keys
media.fields=url,preview_image_url,alt_text,public_metrics
```
***
## Notes importantes
**Vous ne pouvez pas demander de sous-champs.** Lorsque vous demandez `public_metrics`, vous obtenez toutes les métriques (mentions J’aime, republications, réponses, citations). Vous ne pouvez pas demander uniquement `public_metrics.like_count`.
* L’ordre des champs dans les réponses peut différer de l’ordre des champs dans la requête
* Des champs manquants dans les réponses signifient que la valeur est `null` ou vide
* Certains champs nécessitent une authentification spécifique (par exemple, les métriques privées requièrent un contexte utilisateur)
* Consultez la Référence de l’API de chaque endpoint pour connaître les champs disponibles
***
## Prochaines étapes
Incluez les objets associés dans les réponses.
Référence complète des champs de tous les objets.