X Articles
Les Articles X, encore souvent appelés articles Twitter, sont des posts longs que les abonnés Premium publient avec un titre, une image de couverture et un corps mis en forme ; ils apparaissent dans les timelines sous forme de court aperçu et recueillent mentions « J’aime », réponses, citations et vues comme n’importe quel post. Disposer du titre, de l’aperçu et du corps entier en texte à côté de ces compteurs permet d’archiver ces écrits longs, de les résumer ou de les classer, et de comparer les performances des Articles à celles des posts habituels d’un auteur.
Fonctionnalités de la X Articles API
- Les Articles à partir de l’URL de leur postEnvoyez un ou plusieurs liens vers les tweets qui publient des Articles, au format x.com/{username}/status/{post_id} : chaque Article renvoie une ligne dont l’id et l’url sont ceux de ce post.
- Le corps complet en texte bruttext contient l’Article entier avec une ligne vide entre les paragraphes, prêt à être découpé en paragraphes ou transmis à une liseuse, un index de recherche ou un modèle de langage.
- Titre, ligne d’aperçu et image de couverturetitle, summary (l’aperçu que X affiche dans les timelines) et cover_url décrivent l’Article tel que les lecteurs le découvrent d’abord dans leur fil.
- Auteur et engagementauthor fournit l’identifiant, le nom affiché, l’avatar et l’indicateur de vérification, metrics fournit les mentions « J’aime », réponses, citations et vues, et published_at indique quand l’Article a été mis en ligne.
Paramètres de la X Articles API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Une ou plusieurs URL de posts X au format /{username}/status/{post_id}, chacune pointant vers le post qui publie un Article. |
Comment utiliser la X Articles API
Envoyez les liens des posts qui portent les Articles, puis lisez une ligne par Article.
- Envoyez {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} en POST à /v1/x/article.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que le status de la tâche indique succeeded.
- Lisez les Articles dans results.items ; tant que has_more vaut true, envoyez results.next_cursor pour obtenir la page suivante.
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'
# text holds the whole Article, with a blank line between paragraphs.Cas d’usage de la X Articles API
- Archiver les écrits longs d’un auteur : Enregistrez title, text, cover_url, published_at et url pour chaque Article afin de conserver une copie consultable de ce qu’un compte a publié en format long.
- Résumer des Articles avec un modèle de langage : Découpez text sur ses lignes vides et confiez les paragraphes à un outil de résumé ou à un modèle de langage, avec title comme contexte, pour transformer de longs Articles en courtes synthèses.
- Comparer les Articles aux posts habituels d’un auteur : Mettez views_count, likes_count et quotes_count des Articles d’un auteur en regard des mêmes compteurs sur ses posts habituels pour voir quel format son audience lit et relaie.
- Suivre un Article après sa mise en ligne : Demandez la même URL à intervalles réguliers et notez comment les vues, les réponses et les citations progressent dans les jours qui suivent published_at.
- Citer des annonces mot pour mot : Quand une agence, une entreprise ou un fondateur publie une annonce sous forme d’Article, reprenez des passages exacts de text et citez-les avec url et published_at.
Conseils d’expert pour la X Articles API
- Si vous ne savez pas quels posts sont des Articles, envoyez-les en un seul lot : seuls les Articles renvoient des lignes et sont facturés, et un lot composé uniquement de posts ordinaires échoue avec un remboursement intégral.
- Affichez summary dans les aperçus et les cartes, et text dans la vue de lecture ; summary reprend les premières lignes du corps, donc concaténer les deux affiche ce passage deux fois.
- Stockez chaque Article sous id, l’ID du post qui le publie, afin qu’une nouvelle collecte du même Article mette à jour ses métriques enregistrées.
- Présentez metrics.comments_count comme le nombre de réponses au post de l’Article lorsque vous intégrez l’engagement des Articles dans un tableau de bord.
API associées
En complément de la X Articles API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques X.
- Twitter Tweet Scraper API — Récupérez le texte des posts publics, auteurs, l’engagement, médias, hashtags, mentions et relations de conversation à partir d’URL de statuts x.com ou twitter.com.
- Twitter Profile Scraper API — Récupérez par nom d’utilisateur l’identité publique d’un compte, ses biographies, avatars, images de couverture, statut du compte et statistiques d’audience visibles.
- Twitter User Tweets Scraper API — Collectez par nom d’utilisateur les posts publics récents, auteurs, médias, hashtags, mentions et l’engagement, hors réponses.
- X Post Quotes API — Collectez les citations publiques de statuts connus à partir de leur URL, avec commentaire, auteurs, engagement, médias, horodatages et contexte du post source.
- X Post Replies API — Collectez les réponses publiques à partir d’URL de posts X avec tri au choix, texte des réponses, auteurs, engagement visible, médias et contexte du post parent.
- Twitter Mentions API — Collectez les posts publics qui mentionnent un compte donné.
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API