Threads Search
La recherche Threads fait remonter les publications que l’application classe en tête pour un mot-clé ou un hashtag, et chacune arrive avec son texte, son auteur, sa date de publication, ses images ou vidéos jointes et ses nombres de J’aime, de réponses et de republications. Elle offre ainsi une lecture rapide de la façon dont on parle en ce moment d’un sujet, d’un produit ou d’un événement, et des comptes qui orientent la conversation.
Fonctionnalités de la Threads Search API
- Une requête, les meilleures publicationsIndiquez un mot-clé ou un hashtag dans query et recevez les meilleures publications que Threads affiche pour lui, une vingtaine environ, dans le classement de l’application.
- J’aime, réponses et republications sur chaque résultatmetrics.likes_count, metrics.comments_count pour les réponses et metrics.shares_count pour les republications montrent quels résultats attirent le plus l’attention.
- Les comptes derrière chaque publicationauthor renvoie le nom d’utilisateur, le nom affiché, l’url du profil, l’avatar et is_verified : les personnes qui mènent un sujet sont identifiées à côté de leurs propos.
- Médias et chronologiemedia liste les images ou vidéos jointes avec leurs dimensions, et published_at date chaque publication pour juger de sa fraîcheur.
Paramètres de la Threads Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Le mot-clé ou le hashtag à rechercher, comme basketball ou le hashtag d’une campagne. Une requête par appel. |
Comment utiliser la Threads Search API
Envoyez une requête et lisez les meilleures publications une fois la tâche terminée.
- Envoyez {"query": "basketball"} en POST à /v1/threads/search et conservez le task_id renvoyé.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche indique succeeded.
- Lisez les publications dans results.items ; si has_more vaut true, demandez la suite avec results.next_cursor.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"basketball"}'
# 0.6 credits per post returned; a search with no matches is free.Cas d’usage de la Threads Search API
- Prendre le pouls d’un sujet : Recherchez un produit, un événement ou une question et lisez le texte des meilleures publications pour voir quels angles et quelles opinions dominent la discussion.
- Identifier les voix qui animent une conversation : Classez les auteurs des résultats selon les J’aime et republications obtenus par leurs posts, en notant ceux qui sont vérifiés, pour bâtir une liste de contacts ou de veille.
- Surveiller un nom de marque ou un hashtag : Lancez la même requête à intervalles réguliers et conservez les nouveaux id de publications avec leur published_at pour tenir un journal continu des nouvelles mentions.
Conseils d’expert pour la Threads Search API
- Découpez un sujet large en plusieurs requêtes plus étroites, noms de produits, variantes d’orthographe ou hashtags associés, puisque chaque recherche renvoie une vingtaine de publications de tête.
- Fusionnez les résultats de requêtes qui se recoupent par id, afin qu’une publication classée pour deux recherches ne soit comptée qu’une fois.
- Lisez metrics.comments_count comme le nombre de réponses et metrics.shares_count comme le nombre de republications lorsque vous nommez les colonnes d’un rapport.
- Transmettez l’url de n’importe quel résultat à Threads Post Replies API si vous avez besoin de la conversation qui se trouve dessous.
API associées
En complément de la Threads Search 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 User Search API — Trouvez des comptes Threads par nom ou nom d’utilisateur, avec pseudos, noms affichés, URL de profil, avatars et statut de vérification.
- 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.