tiktok/
search-photos

Cerca i caroselli di foto di TikTok per parola chiave escludendo i video e ottieni ogni immagine delle slide insieme a didascalia, hashtag, creator e conteggi di visualizzazioni, Mi piace, commenti e condivisioni.

TikTok Photo Search API

Ricerca per parola chiave
Solo post foto
Ogni immagine del carosello
0,6 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Photo Search

Un post foto di TikTok è una serie di immagini fisse da scorrere, pubblicata con didascalia, hashtag e un suono, e raccoglie gli stessi contatori di visualizzazioni, Mi piace, commenti e condivisioni di un video. Cercare solo questi post mostra quali formati visivi funzionano per un argomento, dalle griglie di outfit ai passaggi delle ricette fino alle liste e alle rassegne di prodotti.

Funzionalità della TikTok Photo Search API

  • Solo post fotoOgni risultato è un carosello di foto e i video sono esclusi, così una ricerca per parola chiave non viene diluita dai risultati video.
  • Ogni slide con le sue dimensionimedia elenca ogni immagine del post nell’ordine delle slide, con type, url, width e height.
  • Engagement e contesto del postmetrics riporta Mi piace, commenti, condivisioni, riproduzioni e visualizzazioni, e ogni post include la didascalia in text, gli hashtag, le menzioni, l’audio e i campi del profilo del creator.

Parametri della TikTok Photo Search API

ParametriObbligatorioDescrizione
queryObbligatorioLa parola chiave per cui trovare post foto.
results_limitFacoltativoQuanti post foto restituire, da 1 a 500. Il valore predefinito è 20.

Come usare la TikTok Photo Search API

Cerca una parola chiave e scorri le pagine dei post foto corrispondenti.

  1. Invia con POST {"query": "outfit ideas", "results_limit": 20} a /v1/tiktok/search-photos.
  2. Interroga GET /v1/tasks/{task_id} finché status è succeeded.
  3. Leggi i post foto da results.items e ripassa results.next_cursor finché has_more è 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.

Casi d’uso della TikTok Photo Search API

  • Benchmark del formato slideshow: Confronta il numero di immagini in media con Mi piace, commenti, condivisioni e visualizzazioni dei caroselli di una parola chiave per vedere quali lunghezze ottengono risposta.
  • Ricerca su didascalie e hashtag: Leggi text e hashtags dei post foto più forti per una parola chiave per vedere come i creator scrivono e taggano i contenuti che rendono.
  • Moodboard delle tendenze visive: Raccogli le immagini delle slide dei post migliori per una parola chiave come outfit ideas per costruire moodboard di riferimento per contenuti di moda, cucina o viaggi.

Consigli degli esperti per la TikTok Photo Search API

  • Ordina i post sommando Mi piace, commenti e condivisioni e dividendo per views_count invece di usare i Mi piace assoluti, così un post forte di un account piccolo non viene sepolto da uno grande; salta i post con views_count vuoto o pari a zero.
  • Esegui ogni formulazione di un argomento come query separata, per esempio outfit ideas e ootd, e deduplica per id quando unisci i risultati, perché uno slideshow può corrispondere a più query.
  • Se ti servono i file, scarica le immagini delle slide subito dopo la fine dell’attività, perché TikTok le fornisce tramite link firmati che scadono.
  • Raggruppa i post per audio.id invece che per audio.title, perché molti post foto usano il suono del creator stesso, il cui titolo è solo un’etichetta generica di suono originale.

Oltre alla TikTok Photo Search API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.

  • TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
  • TikTok Hashtags API — Raccoglie video pubblici, creator, media, suoni ed engagement per gli hashtag indicati.
  • TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
  • TikTok Search API — Cerca video pubblici per parola chiave con ordinamento e filtri di pubblicazione supportati.
  • TikTok Live Room Info API — Consulta una diretta nota tramite la coppia di ID della stanza e del proprietario, restituendo stato, contesto del proprietario, immagine di copertina e conteggi del pubblico.
  • TikTok Comment Keywords API — Trova le parole chiave più ricorrenti nei commenti di un video, insieme ai commenti da cui provengono.

Esplora altre piattaforme

Combina i dati di TikTok con i dati pubblici delle altre piattaforme social supportate.

TikTok Photo Search API — FAQ

TikTok Photo Search API è un’interfaccia programmatica per cercare per parola chiave i post a carosello di foto di TikTok. Restituisce ogni immagine di ciascun post insieme a didascalia, creator, hashtag e conteggi di visualizzazioni, Mi piace, commenti e condivisioni.

Questo endpoint restituisce solo caroselli di foto ed esclude i video dai risultati.

In pratica sì. TikTok chiama questo formato post foto o modalità foto, mentre i creator li chiamano slideshow o caroselli; ogni risultato qui è uno di questi post, con le sue slide in media.

Tutte. media elenca ogni immagine nell’ordine delle slide, ciascuna con url, width e height.

No. Un risultato riporta Mi piace, commenti, condivisioni, riproduzioni e visualizzazioni, ma non include un conteggio dei salvataggi.

Top Search restituisce video e caroselli di foto mescolati per una parola chiave, mentre Photo Search tiene solo i caroselli, quindi ogni risultato ha le sue immagini in media.

results_limit accetta da 1 a 500, con 20 come valore predefinito. Ogni post foto restituito costa 0,6 crediti e una ricerca senza post foto corrispondenti non costa nulla.