---
title: "Vue d'ensemble de l'API"
description: "Référence REST TwexAPI — authentification, format de réponse, pagination, erreurs, limites de débit et groupes d'endpoints."
---

TwexAPI expose une API REST à `https://api.twexapi.io` pour les lectures, écritures, recherches, abonnés, DM, listes, communautés, articles et utilitaires de compte X/Twitter.

Utilisez cette page comme point d'entrée avant d'ouvrir les pages d'endpoints individuelles dans la barre latérale.

## URL de base

```txt
https://api.twexapi.io
```

## Authentification

Envoyez votre clé API à chaque requête :

```bash
Authorization: Bearer YOUR_API_KEY
```

Public docs focus on API-key reads.

## Format de réponse

Les réponses réussies utilisent une enveloppe cohérente :

```json
{
  "code": 200,
  "msg": "success",
  "data": {}
}
```

Les erreurs renvoient des codes HTTP non 2xx avec un corps JSON. Consultez [Gestion des erreurs](/guides/error-handling) pour les conseils de récupération par statut.

## Pagination

De nombreux endpoints de liste et de recherche renvoient des champs de curseur tels que `has_next_page`, `next_cursor` ou des jetons de page dans `data`. Transmettez le curseur de la réponse précédente sans modification à la requête suivante. Conservez les curseurs en dehors de la mémoire de chat ou de workflow lorsque les tâches doivent reprendre après des échecs.

## Vérifier le solde

Inspectez les crédits restants avant de grandes exportations :

```bash
curl --request GET \
  --url 'https://api.twexapi.io/balance' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

Consultez [Get Balance](/api-reference/balance-endpoints/get-balance-api-balance-get) pour le schéma complet.

## Groupes d'endpoints

Parcourez les pages générées sous **Endpoints** dans la barre latérale, ou accédez directement aux groupes courants :

| Groupe | Tâches typiques |
| --- | --- |
| [Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post) | Recherche par mot-clé, hashtags, cashtags. Construisez `searchTerms` avec [Advance Search TwitterXAPI](https://x-advanced-search.cc). |
| [Users](/api-reference/twitter-user-about-endpoints/get-twitter-user-about-by-screen-name-api-twitter-screen-name-about-get) | Consultation de profil, lectures utilisateur par lot |
| [Followers & Following](/api-reference/followers-following-endpoints/followers-v3-api-v3-twitter-users-followers-post) | Export d'abonnés et d'abonnements |
| [Tweet Actions](/api-reference/tweet-actions-endpoints/create-tweet-twitter-tweets-create-post) | Publication, réponse, like, retweet, signet |
| [Trending](/api-reference/trending-endpoints/get-global-trending-tweets-api-twitter-global-trending-tweets-get) | Sujets et tweets tendances mondiaux |
| [DM](/api-reference/dm-endpoints/send-dm-v3-api-v3-twitter-send-dm-post) | Statut DM, envoi et historique |
| [Balance](/api-reference/balance-endpoints/get-balance-api-balance-get) | Solde de crédits |

## Chemins agent et SDK

| Intégration | Quand l'utiliser |
| --- | --- |
| [Serveur MCP](/mcp/overview) | Agents IA qui doivent découvrir les routes avec `explore` avant d'appeler `twexapi_request` |
| [SDK](/sdks) | Clients typés avec retries et helpers de pagination |
| [CLI](/sdks/cli) | Scripts terminal et sortie JSON |
| [Guides de frameworks](/guides/langchain) | LangChain, CrewAI, n8n, Prefect et autres hôtes d'agents |

## Guides opérationnels

- [Gestion des erreurs](/guides/error-handling) — récupération HTTP, erreurs MCP et retries d'écriture
- [Limites de débit](/guides/rate-limits) — conseils de débit et backoff sur `429`
- — cookie / `auth_token`, vérifications des doublons et crédits `403`
- [Authentification](/authentication) — clés API, en-têtes Bearer et identifiants d'écriture

## Ce que TwexAPI n'expose pas aujourd'hui

TwexAPI ne propose pas nativement de **moniteurs de compte**, de **webhooks d'événements** ou de **tâches d'extraction asynchrones** en tant que produits API de premier ordre. Utilisez des appels REST planifiés (Prefect, n8n, cron) ou des webhooks de plateformes no-code pour recevoir les transferts d'agents, puis continuez avec des requêtes API directes.