threads/
user-posts

Collectez les publications Threads publiques d’une ou plusieurs URL de profil prises en charge, sous forme d’enregistrements normalisés avec texte, contexte de l’auteur, médias, horodatages et engagement visible.

Threads User Posts API

URL de profil en entrée
Limite de résultats par profil
Publications publiques normalisées
0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlsObligatoireListe 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_limitFacultatifNombre 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.

  1. Préparez une ou plusieurs URL de profil Threads publiques au format /@username sur threads.com ou threads.net.
  2. Envoyez urls et, si besoin, results_limit en POST à /v1/threads/user-posts, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

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

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.

Explorer d’autres plateformes

Combinez les données Threads avec les données publiques d’autres plateformes sociales prises en charge.

Threads User Posts API — FAQ

Threads User Posts API découvre les publications publiques d’une ou plusieurs URL de profil Threads prises en charge. Elle renvoie le texte normalisé, le contexte de l’auteur, les médias, les horodatages, l’engagement visible et le profil envoyé.

Envoyez une URL HTTP ou HTTPS sur threads.com, www.threads.com, threads.net ou www.threads.net dont le chemin suit le format /@username. Les noms d’utilisateur seuls, les URL de publication et les autres formes de chemin sont rejetés.

Les enregistrements peuvent contenir l’ID de la publication, l’URL, le texte, l’identité publique de l’auteur, les références de médias, les nombres visibles de mentions J’aime, de commentaires, de reposts et de partages, created_at, collected_at, ainsi que du contexte supplémentaire de découverte ou d’entrée. Les valeurs source facultatives peuvent être null ou vides.

results_limit vaut 100 par défaut et accepte les entiers de 1 à 2 000. Il s’applique à chaque URL de profil : deux URL avec results_limit 50 demandent donc jusqu’à 100 publications.

Non, la réponse normalisée n’expose aucun sous-type de publication. Considérez chaque élément comme une publication publique découverte à partir de l’URL de profil envoyée, sans en déduire s’il s’agit d’une publication originale, d’une réponse, d’une citation ou d’un repost.

Chaque publication renvoyée coûte 0,5 crédit SocQ. L’estimation repose sur urls multiplié par results_limit, et un jeu de résultats vide n’entraîne aucun frais de résultat.