x/
article

Récupérez le texte complet d’Articles X à partir des URL des posts qui les publient, avec titre, aperçu affiché dans la timeline, image de couverture, auteur et engagement, sauts de paragraphe conservés.

X Articles API

URL du post en entrée
Corps complet de l’Article
Titre, aperçu et couverture
0,7 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlsObligatoireUne 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.

  1. Envoyez {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} en POST à /v1/x/article.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que le status de la tâche indique succeeded.
  3. 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.

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é.

Explorer d’autres plateformes

Combinez les données X avec les données publiques d’autres plateformes sociales prises en charge.

X Articles API — FAQ

X Articles API est une interface programmatique qui lit les Articles X, ces posts longs dotés d’un titre et d’une image de couverture, à partir des URL des posts qui les publient. Elle renvoie le titre, l’aperçu affiché dans la timeline, le texte intégral du corps, l’URL de l’image de couverture, l’auteur et les nombres de mentions « J’aime », de réponses, de citations et de vues.

Les Articles X sont des posts longs que les abonnés Premium peuvent publier sur X, avec un titre, une image de couverture et un corps mis en forme. Ils apparaissent dans les timelines comme un post accompagné d’un court aperçu, et les lecteurs les ouvrent pour lire le texte en entier.

Utilisez le lien du post qui publie l’Article, au format x.com/{username}/status/{post_id}. Plusieurs liens peuvent être placés en même temps dans urls, et chaque Article revient sur sa propre ligne.

Ce post ne renvoie aucune ligne et ne coûte rien, tandis que les Articles de la même requête sont tout de même renvoyés. Si aucune des URL n’est un Article, la tâche échoue et est intégralement remboursée.

L’image de couverture est renvoyée dans cover_url. Les images insérées dans le corps ne sont pas incluses ; text contient uniquement le contenu rédigé.

Oui. text contient le corps entier en texte brut avec une ligne vide entre les paragraphes : il peut être enregistré dans un fichier .txt ou utilisé comme paragraphes Markdown, avec title ajouté en tête comme titre.