TikTok Photo Search
Une publication photo TikTok est une série d’images fixes à faire défiler, publiée avec une légende, des hashtags et un son, et elle cumule les mêmes compteurs de vues, de likes, de commentaires et de partages qu’une vidéo. Rechercher uniquement ces publications montre quels formats visuels fonctionnent sur un sujet, des grilles de tenues aux étapes de recettes, en passant par les listes et les sélections de produits.
Fonctionnalités de la TikTok Photo Search API
- Publications photo uniquementChaque résultat est un carrousel photo et les vidéos sont écartées : une recherche par mot-clé n’est donc pas diluée par des résultats vidéo.
- Chaque diapositive avec ses dimensionsmedia liste chaque image de la publication dans l’ordre des diapositives, avec son type, son url, sa largeur et sa hauteur.
- Engagement et contexte de la publicationmetrics indique les likes, les commentaires, les partages, les lectures et les vues, et chaque publication s’accompagne de sa légende en texte, de ses hashtags, de ses mentions, du son et des champs de profil du créateur.
Paramètres de la TikTok Photo Search API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé pour lequel chercher des publications photo. |
results_limit | Facultatif | Nombre de publications photo à renvoyer, de 1 à 500. 20 par défaut. |
Comment utiliser la TikTok Photo Search API
Cherchez un mot-clé et parcourez page par page les publications photo correspondantes.
- Envoyez {"query": "outfit ideas", "results_limit": 20} en POST à /v1/tiktok/search-photos.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les publications photo dans results.items et renvoyez results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"outfit ideas","results_limit":20}'
# media holds every image of each carousel, in slide order.Cas d’usage de la TikTok Photo Search API
- Étalonner les formats de diaporama : Comparez le nombre d’images de media avec les likes, commentaires, partages et vues des carrousels d’un mot-clé pour voir quelles longueurs déclenchent des réactions.
- Recherche de légendes et de hashtags : Lisez text et hashtags dans les meilleures publications photo d’un mot-clé pour voir comment les créateurs formulent et étiquettent les contenus qui performent.
- Tableaux d’inspiration visuelle : Rassemblez les images des publications les mieux classées pour un mot-clé comme outfit ideas afin de constituer des planches de référence pour des contenus mode, cuisine ou voyage.
Conseils d’expert pour la TikTok Photo Search API
- Classez les publications selon la somme des likes, commentaires et partages divisée par views_count plutôt que selon les seuls likes, afin qu’une bonne publication d’un petit compte ne soit pas noyée par celle d’un gros ; ignorez les publications dont views_count est vide ou nul.
- Lancez chaque formulation d’un sujet comme une requête distincte, par exemple outfit ideas et ootd, et dédoublonnez sur id en fusionnant les résultats, car un même diaporama peut répondre à plusieurs requêtes.
- Téléchargez les images des diapositives peu après la fin de la tâche si vous avez besoin des fichiers : TikTok les sert par des liens signés qui expirent.
- Regroupez les publications par audio.id plutôt que par audio.title, car beaucoup de publications photo utilisent le son original du créateur, dont le titre n’est qu’une étiquette générique.
API associées
En complément de la TikTok Photo Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.
- TikTok Profiles API — Récupérez par nom d’utilisateur l’identité publique d’un profil, ses biographies, indicateurs de compte et nombres d’audience.
- TikTok Hashtags API — Collectez les vidéos publiques, créateurs, médias, sons et l’engagement pour des hashtags donnés.
- TikTok Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
- TikTok Search API — Recherchez des vidéos publiques par mot-clé avec tris et filtres de publication pris en charge.
- TikTok Live Room Info API — Consultez un live connu à partir de la paire d’ID de salle et de propriétaire, et obtenez le statut, le contexte du propriétaire, le média de couverture et les nombres d’audience.
- TikTok Comment Keywords API — Trouvez les mots-clés qui reviennent le plus dans les commentaires d’une vidéo, avec les commentaires correspondants.
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API