Retour aux API
Données publiques X

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.

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.

FluxEndpoints X de SocQProduits développeur de X
Meilleur usageEnrichissement de profils, étude de posts, veille et découverte de sujets publicsIntégrations d’applications et de comptes gérées par X
Entrée de départNoms d’utilisateur, URL de statuts, listes de comptes, expression de recherche ou WOEID connusRequêtes propres à chaque produit et contexte de compte autorisé
AuthentificationClé API SocQIdentifiants développeur X et autorisation applicable
Forme des donnéesEnregistrements normalisés de profils, de posts et de tendancesRéponses natives de X propres à chaque produit
Modèle de traitementTâche asynchrone suivie d’une pagination des résultatsCycle 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. 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. 2. Suivre la tâche

    Utilisez task_id avec /v1/tasks/{task_id} jusqu’à la fin du traitement.

  3. 3. Récupérer les résultats

    Lisez data.results.items et utilisez next_cursor tant que has_more vaut true.

Commencer avec une seule requête d’API

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 true

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

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.