tiktok/
search-photos

Recherchez des carrousels photo TikTok par mot-clé, sans les vidéos, et obtenez chaque image avec la légende, les hashtags, le créateur et les nombres de vues, de likes, de commentaires et de partages.

TikTok Photo Search API

Recherche par mot-clé
Publications photo uniquement
Toutes les images du carrousel
0,6 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

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ètresObligatoireDescription
queryObligatoireMot-clé pour lequel chercher des publications photo.
results_limitFacultatifNombre 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.

  1. Envoyez {"query": "outfit ideas", "results_limit": 20} en POST à /v1/tiktok/search-photos.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

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

TikTok Photo Search API — FAQ

TikTok Photo Search API est une interface programmatique pour rechercher par mot-clé des carrousels photo TikTok. Elle renvoie toutes les images de chaque publication avec la légende, le créateur, les hashtags et les nombres de vues, de likes, de commentaires et de partages.

Cet endpoint ne renvoie que des carrousels photo : les vidéos sont écartées des résultats.

En pratique, oui. TikTok parle de publications photo ou de mode Photo, et les créateurs de diaporamas ou de carrousels ; chaque résultat ici correspond à une telle publication, avec ses diapositives dans media.

Toutes. media liste chaque image dans l’ordre des diapositives, avec son url, sa largeur et sa hauteur.

Non. Un résultat indique les likes, les commentaires, les partages, les lectures et les vues, mais pas le nombre d’enregistrements.

Top Search renvoie pour un mot-clé un mélange de vidéos et de carrousels photo, alors que Photo Search ne garde que les carrousels : chaque résultat a donc ses images dans media.

results_limit accepte de 1 à 500, avec 20 par défaut. Chaque publication photo renvoyée est facturée 0,6 crédit, et une recherche sans publication photo correspondante ne coûte rien.