Threads Profiles
Les profils Threads sont des pages de compte publiques réunissant noms d’utilisateur, noms affichés, biographies, images de profil, sites web et nombres visibles d’abonnés, d’abonnements et de publications. Ces champs d’identité et ces signaux de compte servent à enrichir des profils, à comparer des comptes publics et à assurer un suivi dans le temps.
Fonctionnalités de la Threads Profiles API
- Lots d’URL de profil prises en chargeTraite une ou plusieurs URL de profil threads.com ou threads.net au chemin /@username, en rejetant les liens de publication et les chemins sans rapport.
- Identité de profil normaliséeRenvoie l’ID du profil, l’URL, le nom d’utilisateur, le nom affiché, la biographie, l’image de profil et le site web lié dans un enregistrement de profil cohérent.
- Instantanés de compte visiblesGarde les nombres d’abonnés, d’abonnements et de publications disponibles avec collected_at, pour que chaque jeu de métriques publiques ait un moment d’observation.
Paramètres de la Threads Profiles API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL de profils Threads publics sur threads.com ou threads.net. Chaque chemin doit suivre le format /@username ; les noms d’utilisateur seuls, les URL de publication et les chemins sans rapport sont rejetés. |
Comment utiliser la Threads Profiles API
Envoyez des URL de profils publics connus, suivez la tâche asynchrone, puis lisez les enregistrements de profil normalisés grâce à la pagination par curseur.
- Préparez une ou plusieurs URL de profils Threads publics au chemin /@username sur threads.com ou threads.net.
- Envoyez les liens dans urls à /v1/threads/profiles et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items, puis demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/threads/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Threads Profiles API
- Enrichissement de profils publics : Ajoutez le nom d’utilisateur, le nom affiché, la biographie, l’image de profil, le site web et l’URL source à des enregistrements liés à des profils Threads connus.
- Comparaison de l’empreinte de comptes : Comparez les nombres visibles d’abonnés, d’abonnements et de publications au sein d’un ensemble choisi de profils publics.
- Suivi de profils publics : Stockez les champs d’identité et les métriques visibles avec collected_at pour comparer la présentation du profil et les signaux de compte d’une collecte à l’autre.
Conseils d’expert pour la Threads Profiles API
- Validez chaque URL par rapport au chemin /@username sur threads.com ou threads.net avant l’envoi, pour que les liens de publication et les chemins sans rapport ne fassent pas échouer la requête.
- Normalisez les URL envoyées et dédoublonnez les profils renvoyés par id lorsqu’il est disponible, en prenant url comme clé stable de repli.
- Considérez la biographie, l’image de profil, le site web et chaque métrique de compte comme des champs facultatifs, afin que les enregistrements publics partiels restent exploitables.
- Gardez collected_at à côté des nombres d’abonnés, d’abonnements et de publications, pour que les exécutions ultérieures restent distinguables comme des instantanés publics séparés.
API associées
En complément de la Threads Profiles API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Threads.
- Threads Posts API — Collectez le texte des publications publiques, le contexte de l’auteur, les médias, horodatages et l’engagement visible à partir d’URL de publications Threads prises en charge.
- Threads User Posts API — Repérez les publications publiques à partir d’URL de profils Threads, avec limite par profil, contenu, auteurs, médias, horodatages, engagement visible et contexte source normalisés.
- Threads Post Replies API — Collectez les réponses sous des publications Threads à partir de leurs URL, avec texte, auteurs, nombres de J’aime et de réponses, médias et ID de la publication commentée.
- Threads Search API — Recherchez sur Threads par mot-clé ou hashtag les meilleures publications, avec texte, auteurs, J’aime, réponses, republications, médias et date de publication.
- Threads User Replies API — Collectez les dernières réponses publiques publiées par un compte à partir d’URL de profils Threads, avec texte, engagement, médias et liens.
- Threads User Reposts API — Collectez les publications qu’un compte a récemment republiées à partir d’URL de profils Threads, chacune sous la forme du post d’origine avec son auteur, son texte, son engagement et ses médias.