Questions fréquentes
Si la réponse n'est pas ici, la référence API est plus détaillée.
Qu'est-ce que XCrap ?
Un service gratuit qui lit les posts, threads et profils publics de X et les renvoie en Markdown, JSON, YAML, CSV ou HTML. Il existe pour que les agents, les bots et les petits projets puissent lire X sans clé API.
C'est vraiment gratuit ?
Oui. Pas de compte, pas de clé, pas de carte, pas d'essai. C'est financé par les dons, et les frais se résument à un domaine et un petit serveur.
Ai-je besoin d'une clé API ?
Non. Aucune clé à générer, aucun en-tête à envoyer. Les limites de débit s'appliquent par adresse IP et par endpoint.
Quelles sont les limites de débit ?
Par IP et par endpoint : 45 requêtes par minute pour les posts et les profils, 15 par minute pour les threads, timelines, réponses et listes d'abonnés, 20 par minute pour les médias, 4 exports d'historique et 6 requêtes bulk toutes les cinq minutes, et 10 recherches tous les quarts d'heure. Chaque réponse indique où vous en êtes dans les en-têtes x-ratelimit. Besoin de plus ? Voyez l'offre Entreprise.
Peut-il lire des comptes privés ou protégés ?
Non, et ça n'arrivera jamais. Les comptes protégés renvoient le même 404 qu'à tout le monde, et les messages privés sont totalement hors d'atteinte. XCrap ne lit que des comptes publics : leurs posts, profils, réponses et listes d'abonnés.
Peut-il lire des posts supprimés ?
Non. Si un post a disparu de X, il a disparu ici. Le cache de cinq jours peut brièvement contenir encore quelque chose supprimé à l'instant, et cette copie saute à l'expiration.
Comment récupérer un thread entier ?
Utilisez /v1/thread avec le lien de n'importe quel post du fil, le premier compris. X ne donne que le parent d'un post : on recoud la timeline de l'auteur par conversation id pour parcourir le fil vers l'avant.
Puis-je télécharger la vidéo ou les images ?
Oui. /v1/media liste chaque fichier joint avec un lien de téléchargement, à tous les bitrates encodés par X. Les fichiers passent en flux direct et ne sont jamais écrits sur notre disque.
Quels formats puis-je obtenir ?
JSON, Markdown, YAML, CSV et une carte HTML autonome. Ajoutez ?format= à n'importe quelle requête, ou envoyez un en-tête Accept.
Comment l'utiliser depuis un agent IA ?
Trois façons. Ajoutez le serveur MCP à la config de votre client, téléchargez le fichier skill et collez-le dans votre prompt, ou pointez votre framework sur la spec OpenAPI.
À quoi sert l'en-tête x-markdown-tokens ?
Une estimation du coût en tokens d'une réponse Markdown, envoyée avec chaque réponse Markdown. Elle permet à un agent de décider si un thread tient dans son contexte avant d'en lire le corps.
Y a-t-il une recherche plein texte ?
Oui : /v1/search accepte toute requête que la recherche de X comprend, opérateurs compris (from:, "expression exacte", since:…), et renvoie les posts les plus récents ou les plus populaires, ou seulement ceux avec photos ou vidéos. C'est l'endpoint à la limite de débit la plus stricte.
Combien de temps gardez-vous mes requêtes ?
Les logs de requêtes contiennent le chemin, l'horodatage, l'IP et les en-têtes, pour repérer les abus et déboguer les pannes. Le contenu des posts est mis en cache cinq jours, puis supprimé. On est un tuyau, pas une archive.
Est-ce légal ?
Lire des pages web publiques n'est pas un accès non autorisé, ce que les tribunaux américains ont confirmé dans hiQ v. LinkedIn. Cela enfreint bien les conditions d'utilisation de X, ce qui relève du contrat entre X et nous, pas du pénal. Vous êtes responsable de ce que vous faites des données que vous recevez.
Je suis sur X et je ne veux pas être lisible via ce service.
Écrivez à [email protected] depuis une adresse rattachable au compte, et le handle passe sur une blocklist vérifiée avant chaque requête. Sans discussion, sans formulaire.
Pourquoi ne pas utiliser l'API officielle ?
Utilisez-la si vous le pouvez. Elle coûte $200 par mois au palier d'entrée et $42,000 au sommet, et le palier gratuit ne peut pas lire les posts du tout. XCrap existe pour tous ceux qui sont sous cette ligne.
Que se passe-t-il quand X change quelque chose ?
Quatre sources se tiennent derrière chaque endpoint et tombent indépendamment. Quand notre propre client casse, les requêtes basculent sur la suivante et continuent de répondre pendant qu'on répare.
Puis-je l'héberger moi-même ?
Non. XCrap est à source fermée et il n'existe aucune distribution à faire tourner. S'il vous faut une capacité garantie pour quelque chose d'important, l'offre Entreprise propose une capacité dédiée et des limites plus hautes : écrivez à [email protected]. L'API gratuite reste gratuite tant que les dons couvrent le serveur.
Puis-je l'utiliser à titre commercial ?
Oui. Il n'y a ni clé de licence ni palier d'usage sur l'API gratuite. Restez dans les limites de débit, et rappelez-vous que vous êtes responsable de votre propre conformité aux conditions de X et au droit des données là où vous opérez. Si votre produit a besoin de plus de capacité, l'offre Entreprise est faite pour ça.
Comment aider ?
Donnez si vous le pouvez, les serveurs sont le seul vrai coût. Signalez ce qui casse. Dites aux autres gens qui construisent des agents que ça existe.
Êtes-vous référencés quelque part ?
Aura++ référence XCrap dans son annuaire, et son badge est ci-dessous. Si vous tenez un annuaire et voulez l'ajouter, écrivez à [email protected] et votre badge rejoindra celui-là.
Toujours bloqué ?
La référence API documente chaque paramètre et chaque code d'erreur.
