TikTok Photo Search
Ein TikTok-Fotobeitrag ist eine wischbare Folge von Standbildern mit Bildunterschrift, Hashtags und Sound, die dieselben Zähler für Aufrufe, Likes, Kommentare und Shares sammelt wie ein Video. Wer nur diese Beiträge durchsucht, sieht, welche visuellen Formate bei einem Thema funktionieren, von Outfit-Rastern und Rezeptschritten bis zu Listicles und Produktübersichten.
Funktionen der TikTok Photo Search API
- Nur FotobeiträgeJedes Ergebnis ist ein Foto-Karussell, Videos bleiben außen vor, sodass eine Stichwortsuche nicht durch Videotreffer verwässert wird.
- Jede Slide mit ihrer Größemedia listet jedes Bild des Beitrags in der Reihenfolge der Slides auf, mit type, url, width und height.
- Interaktion und Beitragskontextmetrics meldet Likes, Kommentare, Shares, Wiedergaben und Aufrufe, und zu jedem Beitrag gehören die Bildunterschrift als Text, Hashtags, Erwähnungen, der Sound und die Profilfelder des Creators.
Parameter der TikTok Photo Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Das Stichwort, zu dem Fotobeiträge gesucht werden. |
results_limit | Optional | Wie viele Fotobeiträge zurückgegeben werden, von 1 bis 500. Standard ist 20. |
So verwenden Sie die TikTok Photo Search API
Suchen Sie ein Stichwort und blättern Sie durch die passenden Fotobeiträge.
- Senden Sie {"query": "outfit ideas", "results_limit": 20} per POST an /v1/tiktok/search-photos.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Fotobeiträge aus results.items und geben Sie results.next_cursor zurück, solange has_more true ist.
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.Anwendungsfälle der TikTok Photo Search API
- Diashow-Formate vergleichen: Vergleichen Sie die Zahl der Bilder in media mit Likes, Kommentaren, Shares und Aufrufen über die Karussells eines Stichworts, um zu sehen, welche Längen Resonanz bekommen.
- Bildunterschriften und Hashtags recherchieren: Lesen Sie text und hashtags der stärksten Fotobeiträge zu einem Stichwort, um zu sehen, wie Creator erfolgreiche Inhalte formulieren und verschlagworten.
- Moodboards für visuelle Trends: Sammeln Sie die Slide-Bilder der Top-Beiträge zu einem Stichwort wie outfit ideas, um Referenzboards für Mode-, Food- oder Reiseinhalte aufzubauen.
Profi-Tipps zur TikTok Photo Search API
- Ordnen Sie Beiträge nach der Summe aus Likes, Kommentaren und Shares geteilt durch views_count und nicht nach reinen Likes, damit ein starker Beitrag eines kleinen Accounts nicht hinter einem großen verschwindet; lassen Sie Beiträge aus, deren views_count leer oder null ist.
- Führen Sie jede Formulierung eines Themas als eigene Suche aus, etwa outfit ideas und ootd, und entfernen Sie Duplikate über id, wenn Sie die Ergebnisse zusammenführen, denn eine Diashow kann zu mehreren passen.
- Laden Sie die Slide-Bilder bald nach Abschluss der Aufgabe herunter, wenn Sie die Dateien brauchen, denn TikTok liefert sie über signierte Links, die ablaufen.
- Gruppieren Sie Beiträge nach audio.id und nicht nach audio.title, denn viele Fotobeiträge tragen den eigenen Sound des Creators, dessen Titel nur eine allgemeine Bezeichnung für Originalton ist.
Verwandte APIs
Ergänzend zur TikTok Photo Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.
- TikTok Profiles API — Öffentliche Profilidentität, Bios, Kontomerkmale und Zahlen zur Zielgruppe per Benutzername abrufen.
- TikTok Hashtags API — Öffentliche Videos, Creators, Medien, Sounds und Interaktionen zu angegebenen Hashtags erfassen.
- TikTok Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
- TikTok Search API — Öffentliche Videos per Keyword suchen – mit unterstützten Sortier- und Veröffentlichungsfiltern.
- TikTok Live Room Info API — Einen bekannten Livestream anhand des Paars aus Raum-ID und Besitzer-ID nachschlagen und Status, Besitzerkontext, Cover-Medien und Zuschauerzahlen zurückgeben.
- TikTok Comment Keywords API — Die häufigsten Keywords in den Kommentaren eines Videos finden – mit den Kommentaren dahinter.
- 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