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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | La parola chiave per cui trovare post foto. |
results_limit | Facoltativo | Quanti 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.
- Invia con POST {"query": "outfit ideas", "results_limit": 20} a /v1/tiktok/search-photos.
- Interroga GET /v1/tasks/{task_id} finché status è succeeded.
- 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.
API correlate
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.
- 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