Threads User Posts
Les publications d’un utilisateur Threads sont des contenus publics repérés sur des pages de profil choisies, avec le texte, l’identité de l’auteur, les références de médias, les dates de publication et les compteurs d’engagement visibles. Ces enregistrements, accompagnés de leur horodatage de collecte, servent à archiver le contenu d’un compte, à étudier les formats et à comparer l’engagement public.
Fonctionnalités de la Threads User Posts API
- Découverte bornée par profilAcceptez une ou plusieurs URL de profil Threads publiques et appliquez results_limit séparément à chaque profil, avec 100 par défaut et une plage admise de 1 à 2 000.
- Publications, auteurs et médias normalisésRenvoie les identifiants de publication, les URL sources, le texte, l’identité de l’auteur lorsqu’elle est disponible et les références de médias publiques dans une structure de résultat cohérente.
- Engagement et contexte de découverteConserve les nombres visibles de mentions J’aime, de commentaires, de reposts et de partages avec la date de publication, collected_at et le profil envoyé, lorsque l’enregistrement source les fournit.
Paramètres de la Threads User Posts API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire d’URL de profil Threads publiques sur threads.com ou threads.net. Chaque chemin doit suivre le format /@username ; les noms d’utilisateur seuls, les URL de publication et les autres chemins sont rejetés. |
results_limit | Facultatif | Nombre maximal de publications demandées pour chaque URL de profil ; vaut 100 par défaut et accepte les entiers de 1 à 2 000. |
Comment utiliser la Threads User Posts API
Envoyez des URL de profil Threads publiques avec une limite de résultats par profil, suivez la tâche asynchrone, puis lisez les publications normalisées grâce à la pagination par curseur.
- Préparez une ou plusieurs URL de profil Threads publiques au format /@username sur threads.com ou threads.net.
- Envoyez urls et, si besoin, results_limit en POST à /v1/threads/user-posts, puis 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/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Threads User Posts API
- Jeux de données de profils choisis : Conservez les ID de publication, les URL sources, le texte, les champs de l’auteur, les références de médias, les horodatages et le profil envoyé pour un ensemble défini de profils publics.
- Étude des contenus et des formats : Exploitez le texte, les références de médias publiques, l’attribution de l’auteur et les dates de publication pour examiner les sujets récurrents et les formats de contenu de profils choisis.
- Comparaison de l’engagement public : Comparez les mentions J’aime, commentaires, reposts et partages visibles entre plusieurs collections de profils, en vous appuyant sur collected_at pour dater chaque observation.
Conseils d’expert pour la Threads User Posts API
- Vérifiez que chaque entrée est une URL de profil threads.com ou threads.net au format /@username avant l’envoi : les noms d’utilisateur seuls, les liens de publication et les autres chemins feraient échouer la requête.
- Calculez la profondeur demandée et l’estimation de crédits préalable comme le nombre d’urls multiplié par results_limit, puisque la limite s’applique séparément à chaque profil.
- Stockez discovery_input, input_url et collected_at avec chaque résultat afin que les enregistrements en aval gardent le profil envoyé et l’heure d’observation.
- Traitez le texte, les champs de l’auteur, les médias, created_at et chaque métrique comme facultatifs, et ne déduisez pas si un enregistrement est une publication originale, une réponse, une citation ou un repost : aucun sous-type n’est exposé.
API associées
En complément de la Threads User Posts 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 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.