X Public Data API
Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.
API X disponibles
Choisissez l’API qui correspond à votre point de départ : un nom d’utilisateur, l’URL d’un post, une liste de comptes, une requête de recherche ou un WOEID numérique connu.

x/profiles
Profils0,6 crédit par résultat

x/followers-list
Profils0,5 crédit par résultat

x/posts
Publications0,5 crédit par résultat

x/post-retweeters
Profils0,5 crédit par résultat

x/user-posts
Publications0,5 crédit par résultat

x/search
Recherche0,7 crédit par résultat

x/following-list
Profils0,5 crédit par résultat

x/post-quotes
Publications0,5 crédit par résultat

x/post-replies
Commentaires0,5 crédit par résultat

x/trends
Recherche0,5 crédit par résultat

x/mentions
Publications0,7 crédit par résultat

x/search-users
Recherche0,6 crédit par résultat

x/community
Profils0,5 crédit par résultat

x/community-posts
Publications0,7 crédit par résultat

x/thread-context
Publications0,5 crédit par résultat

x/user-about
Profils0,7 crédit par résultat

x/verified-followers
Profils0,7 crédit par résultat

x/list-posts
Publications0,7 crédit par résultat

x/list-members
Profils0,7 crédit par résultat

x/list-followers
Profils0,7 crédit par résultat

x/community-members
Profils0,7 crédit par résultat

x/community-moderators
Profils0,7 crédit par résultat

x/search-communities
Recherche0,7 crédit par résultat

x/article
Publications0,7 crédit par résultat

x/space
Publications0,7 crédit par résultat

x/user-media
Publications0,7 crédit par résultat

x/user-replies
Commentaires0,7 crédit par résultat

x/check-follow
Profils0,7 crédit par résultat

x/post-transcript
Publications0,7 crédit par résultat
Quelles données X pouvez-vous récupérer ?
Constituez un jeu de données autour de l’identité des comptes, de contenus connus, de l’activité récente de publication, de la découverte de posts ou des sujets actuels par lieu.
Profils de comptes publics
Transformez des noms d’utilisateur en identité de profil, biographie, éléments visuels, statut du compte, indicateurs d’audience, listes d’abonnés, listes d’abonnements et date de collecte.
Détails de posts connus
Résolvez des URL de statuts publics en détails de posts, réponses, citations, profils des comptes qui ont reposté, médias, relations et engagement visible.
Posts récents par compte
Collectez les posts publics récents, hors réponses, de noms d’utilisateur choisis et comparez l’activité au sein d’une liste de comptes.
Recherche et découverte de posts
Recherchez des posts publics avec une seule requête, choisissez l’ordre par plus récents ou par popularité, et gardez la requête rattachée à chaque résultat.
Tendances actuelles par WOEID
Collectez un instantané par lieu des noms de tendances, des rangs source, des requêtes, des descriptions et des heures d’observation.
SocQ vs les produits développeur de X
SocQ est conçu pour des flux de recherche homogènes sur des données publiques. Les produits développeur de X prennent en charge des intégrations gérées par X, selon leurs propres produits et exigences d’autorisation.
| Flux | Endpoints X de SocQ | Produits développeur de X |
|---|---|---|
| Meilleur usage | Enrichissement de profils, étude de posts, veille et découverte de sujets publics | Intégrations d’applications et de comptes gérées par X |
| Entrée de départ | Noms d’utilisateur, URL de statuts, listes de comptes, expression de recherche ou WOEID connus | Requêtes propres à chaque produit et contexte de compte autorisé |
| Authentification | Clé API SocQ | Identifiants développeur X et autorisation applicable |
| Forme des données | Enregistrements normalisés de profils, de posts et de tendances | Réponses natives de X propres à chaque produit |
| Modèle de traitement | Tâche asynchrone suivie d’une pagination des résultats | Cycle de requête et de réponse propre à chaque produit |
Fonctionnement de l’API X
Chaque API X suit le même schéma : envoyer, suivre, récupérer.
1. Envoyer votre entrée
Envoyez des noms d’utilisateur, des URL de statuts, une liste de comptes, une requête de recherche ou des WOEID numériques à l’API correspondante.
2. Suivre la tâche
Utilisez task_id avec /v1/tasks/{task_id} jusqu’à la fin du traitement.
3. Récupérer les résultats
Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.
Authentifiez-vous avec votre clé API SocQ et envoyez un ou plusieurs noms d’utilisateur X. Les posts, les posts d’un utilisateur, la recherche et les tendances suivent le même flux de tâche.
curl -X POST "https://api.socq.ai/v1/x/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@OpenAI"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage courants de l’API X
Étude des créateurs et des partenaires
Enrichissez des noms d’utilisateur connus, comparez les signaux publics des comptes et constituez des profils de créateurs homogènes.
Veille sur les marques et le marché
Suivez des comptes choisis, répétez des recherches stables ou capturez les tendances de WOEID connus pour constituer des jeux de données horodatés sur des marques, des concurrents et des sujets.
Reporting sur les contenus de campagne
Résolvez les URL de posts d’une campagne et organisez les contenus, les auteurs, les médias, les relations et l’engagement au moment de la collecte.
Recherche et produits de données
Utilisez des enregistrements homogènes de profils et de posts dans vos entrepôts de données, classifieurs, index de recherche, outils de revue et tableaux de bord.
Limites et politique sur les données publiques
SocQ renvoie les données X accessibles publiquement telles qu’elles apparaissent au moment où la tâche s’exécute.
- Les compteurs de profils et l’engagement des posts sont des instantanés rattachés à collected_at.
- Les résultats de recherche suivent l’ordre choisi, plus récents ou popularité, au moment de la collecte.
- Les rangs et descriptions des tendances proviennent de la source et représentent le WOEID demandé au moment de la collecte.
- results_limit fixe un maximum, mais le nombre de résultats renvoyés dépend des enregistrements publics éligibles disponibles pendant la tâche.
- Ces API ne lisent que des données publiques et ne publient pas de posts ni ne gèrent de comptes X.
Questions fréquentes sur l’API X
Que peut-on collecter avec l’API X ?
Vous pouvez récupérer des profils publics, des listes d’abonnés et d’abonnements, des posts connus, des posts récents, des réponses, des citations, les profils des comptes qui ont reposté, des résultats de recherche et les tendances actuelles de WOEID numériques connus.
Quelle API X choisir ?
Utilisez Profiles, Followers List ou Following List pour les comptes ; Posts, Post Replies, Post Quotes ou Post Retweeters pour les URL de statuts ; User Posts pour l’activité récente d’un compte ; Search pour la découverte par requête ; et Trends pour des WOEID numériques connus.
Comment fonctionne le traitement des tâches ?
Envoyez une requête POST, interrogez /v1/tasks/{task_id}, puis lisez data.results.items et poursuivez avec next_cursor tant que has_more vaut true.
Que contient chaque résultat ?
Les résultats contiennent les champs disponibles pour l’API concernée, comme l’identité du profil, le contenu et les médias d’un post, ou le nom de la tendance, son rang source, le WOEID, la requête, la description et la date de collecte.
Les indicateurs X sont-ils en temps réel ?
Non. Les compteurs de comptes, l’engagement des posts et les rangs des tendances sont des instantanés. Utilisez collected_at comme heure d’observation pour comparer les résultats.
Comment la collecte de données X est-elle facturée ?
Profiles coûte 0,6 crédit par résultat, les posts directs, les posts d’un utilisateur et les tendances coûtent 0,5, et les résultats de recherche coûtent 0,7.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
LinkedIn API
Récupérez des données LinkedIn publiques de profils, d’entreprises, de publications et d’offres d’emploi à partir d’URL connues, avec des champs normalisés d’identité, de carrière, d’entreprise, de contenu, d’engagement et d’offre.
Reddit API
Récupérez les publications et commentaires Reddit publics à partir d’URL connues, parcourez les publications récentes, les mieux notées ou tendance d’un subreddit, ou recherchez des discussions par mot-clé et par période de publication.
Pinterest API
Récupérez les données de profils Pinterest publics, résolvez des Pins connus, collectez les Pins de profils sélectionnés ou lancez une recherche par mot-clé pour étudier les créateurs, les contenus et les tendances visuelles.
Threads API
Récupérez des profils Threads publics, résolvez des publications connues ou collectez les publications de profils sélectionnés, avec des champs normalisés d’identité, de contenu, de médias, d’engagement et d’horodatage.
Bluesky API
Récupérez des profils Bluesky publics, résolvez des URL de publications connues ou collectez une page de publications d’un compte, avec identité, contenu, médias, horodatages et champs d’engagement visibles normalisés.
Snapchat API
Récupérez un Spotlight Snapchat public connu sous forme d’enregistrement normalisé, avec les champs disponibles de créateur, de légende, de média, d’audio, de date, de durée et d’engagement.