tiktok/
search-photos

TikTok-Foto-Karussells per Stichwort durchsuchen, ohne Videos, und jedes Bild der Slides samt Bildunterschrift, Hashtags, Creator sowie Aufrufen, Likes, Kommentaren und Shares erhalten.

TikTok Photo Search API

Stichwortsuche
Nur Fotobeiträge
Jedes Karussell-Bild
0,6 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
queryErforderlichDas Stichwort, zu dem Fotobeiträge gesucht werden.
results_limitOptionalWie 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.

  1. Senden Sie {"query": "outfit ideas", "results_limit": 20} per POST an /v1/tiktok/search-photos.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. 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.

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.

Weitere Plattformen entdecken

Kombinieren Sie TikTok-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Photo Search API — FAQ

TikTok Photo Search API ist eine Schnittstelle zur Suche nach TikTok-Foto-Karussells per Stichwort. Sie liefert jedes Bild eines Beitrags zusammen mit Bildunterschrift, Creator, Hashtags sowie den Zahlen für Aufrufe, Likes, Kommentare und Shares.

Dieser Endpunkt liefert ausschließlich Foto-Karussells, Videos bleiben aus den Ergebnissen heraus.

In der Praxis ja. TikTok nennt das Format Fotobeiträge oder Fotomodus, Creator sprechen von Diashows oder Karussells; jedes Ergebnis hier ist ein solcher Beitrag, dessen Slides in media stehen.

Alle. media listet jedes Bild in der Reihenfolge der Slides auf, jeweils mit url, width und height.

Nein. Ein Ergebnis meldet Likes, Kommentare, Shares, Wiedergaben und Aufrufe, eine Zahl der Speicherungen gehört nicht dazu.

Top Search liefert zu einem Stichwort Videos und Foto-Karussells gemischt, Photo Search behält nur die Karussells, sodass jedes Ergebnis seine Bilder in media hat.

results_limit akzeptiert 1 bis 500 und steht standardmäßig auf 20. Jeder zurückgegebene Fotobeitrag wird mit 0,6 Credits berechnet, eine Suche ohne passende Fotobeiträge kostet nichts.