Threads User Reposts
Les republications d’un utilisateur Threads sont les publications qu’un compte a choisi de repartager avec ses abonnés, chacune étant le post d’origine avec son créateur, son texte, ses médias, sa date de publication et les J’aime, réponses et republications qu’il a déjà recueillis. Comme une republication est un soutien délibéré, cette liste montre quelles voix un compte amplifie, quels partenaires une marque met en avant et quels contenus circulent au sein d’une communauté.
Fonctionnalités de la Threads User Reposts API
- Le post d’origine derrière chaque republicationChaque ligne est la publication republiée, avec author défini sur son créateur d’origine : vous voyez précisément de qui le compte a relayé le contenu.
- L’engagement de l’originalmetrics.likes_count, metrics.comments_count et metrics.shares_count donnent les J’aime, réponses et republications du post d’origine, soit l’audience dont bénéficiait déjà le contenu amplifié.
- Les republications récentes depuis un lien de profilurls accepte des liens de profils comme https://www.threads.com/@shams, et chaque profil renvoie les publications qu’il a récemment republiées, environ 25.
Paramètres de la Threads User Reposts API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liens de profils Threads au format /@{username} sur threads.com ou threads.net, comme https://www.threads.com/@shams. |
Comment utiliser la Threads User Reposts API
Envoyez un lien de profil et lisez les publications qu’il a republiées.
- Envoyez {"urls": ["https://www.threads.com/@shams"]} en POST à /v1/threads/user-reposts et enregistrez le task_id.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les publications republiées dans results.items en suivant results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@shams"]}'
# 0.5 credits per reposted post returned.Cas d’usage de la Threads User Reposts API
- Cartographier les contenus qu’un compte amplifie : Comptez les author.username parmi les republications d’un profil pour classer les créateurs et les médias qu’il relaie le plus souvent.
- Repérer les partenaires qu’une marque met en avant : Examinez les auteurs d’origine et le texte des republications d’une marque pour identifier les collaborateurs, ambassadeurs et médias qu’elle choisit de promouvoir.
- Retracer les contenus qui se propagent dans une communauté : Collectez les republications d’un ensemble de comptes d’une même niche et trouvez les id de publications que plusieurs d’entre eux ont relayées.
Conseils d’expert pour la Threads User Reposts API
- Envoyez un profil par tâche si vous devez savoir quel compte a fait chaque republication, car author désigne sur chaque ligne le créateur d’origine.
- Considérez published_at comme la date de publication du post d’origine ; pour dater l’apparition des republications, collectez régulièrement et notez la première apparition de chaque id.
- Envoyez l’url d’une ligne à Threads Post Replies API pour lire la conversation sous une publication qu’un compte a choisi d’amplifier.
API associées
En complément de la Threads User Reposts 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 Profiles API — Collectez l’identité publique d’un profil, ses biographies, images, sites web, nombres visibles et le contexte de collecte à partir d’URL de profils 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.