douyin/
video-search

Recherchez la première page fixe de vidéos Douyin publiques à partir d’une requête texte, avec légendes normalisées, contexte de l’auteur, médias, durée, horodatages et engagement visible, lorsqu’ils sont disponibles.

Douyin Video Search API

Requête texte
Première page fixe
Vidéos normalisées
0,1 crédit par requête
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

Douyin Video Search

Douyin Video Search convertit une requête texte non vide en jeu de données borné de vidéos publiques. Chaque tâche envoie au fournisseur une requête fixe pour la page 1 avec un offset de 0, puis stocke les enregistrements renvoyés dans le format vidéo de SocQ, pour une lecture homogène en aval.

Fonctionnalités de la Douyin Video Search API

  • Contrat de recherche à un seul champN’envoyez que query. L’endpoint rejette les entrées non déclarées, comme results_limit, et ne demande ni jeton de fournisseur ni identifiant interne.
  • Requête source bornéeChaque tâche demande au fournisseur la page 1 avec un offset de 0, sans exposer à l’appelant de contrôles de pagination du fournisseur.
  • Enregistrements vidéo normalisésLisez le texte, l’auteur, les médias, la durée, les horodatages et les nombres visibles de lectures, de mentions J’aime, de commentaires et de partages disponibles grâce à un schéma de résultat cohérent.
  • Lecture asynchrone des résultats stockésEnvoyez la tâche une fois, interrogez-la, et n’utilisez le curseur de résultats de SocQ que si la tâche terminée a stocké plus d’enregistrements qu’une page de réponse n’en renvoie.

Paramètres de la Douyin Video Search API

ParamètresObligatoireDescription
queryObligatoireRequête texte obligatoire et non vide. Elle est transmise au champ de mot-clé du fournisseur, tandis que la page et l’offset restent fixés par le backend.

Comment utiliser la Douyin Video Search API

Fournissez une requête non vide, attendez la tâche asynchrone, puis lisez les enregistrements normalisés stockés pour cette tâche.

  1. Choisissez une requête texte précise qui décrit les vidéos publiques que vous souhaitez découvrir.
  2. Envoyez query en POST à /v1/douyin/video-search et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
  4. Lisez data.results.items. Si has_more vaut true, transmettez next_cursor à la requête de résultats de la tâche pour parcourir les enregistrements SocQ stockés.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"street food"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor pages stored SocQ results only

Cas d’usage de la Douyin Video Search API

  • Découverte de vidéos par thème : Constituez un instantané borné des vidéos publiques renvoyées pour un produit, un thème, un événement ou une expression de recherche.
  • Revue du contexte des créateurs : Rapprochez les légendes et médias renvoyés des champs publics disponibles de l’auteur pour la recherche qualitative et l’enrichissement de jeux de données.
  • Analyse des formats et des médias : Examinez les médias vidéo, vignettes, dimensions et durées disponibles à côté de l’enregistrement source et du contexte de la requête.
  • Instantanés de l’engagement visible : Comparez les nombres de lectures, de mentions J’aime, de commentaires et de partages disponibles, en conservant collected_at comme heure d’observation.

Conseils d’expert pour la Douyin Video Search API

  • Exigez dans votre propre interface un texte de requête significatif, qui ne soit pas composé uniquement d’espaces, avant d’envoyer la tâche.
  • N’envoyez ni results_limit, ni page, ni offset, ni search_id, ni curseur du fournisseur ; ils ne font pas partie du schéma de requête public de SocQ.
  • Considérez l’ensemble renvoyé comme une seule réponse du fournisseur, et non comme un index de recherche exhaustif ni une fenêtre de classement pilotée par l’appelant.
  • N’utilisez cursor et limit de GET /v1/tasks/{task_id} que pour lire les résultats stockés ; limit vaut 50 par défaut et accepte de 1 à 500.
  • Conservez collected_at et gérez les champs facultatifs d’auteur, de médias, de publication, de durée et de métriques individuelles sans remplacer par zéro les valeurs manquantes.

En complément de la Douyin Video Search API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Douyin.

Explorer d’autres plateformes

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

Douyin Video Search API — FAQ

Douyin Video Search API recherche la première page fixe de vidéos Douyin publiques avec une requête texte et renvoie des enregistrements vidéo normalisés.

Seul query est accepté, et il doit être une chaîne non vide. L’endpoint n’accepte ni results_limit, ni page, ni offset, ni curseur de fournisseur fourni par l’appelant.

Non. Le backend envoie toujours la page 1 avec un offset de 0 dans une seule requête au fournisseur, et n’expose aucun contrôle de pagination de la source.

Un next_cursor renvoyé par GET /v1/tasks/{task_id} fait avancer dans les enregistrements déjà stockés par SocQ pour la tâche terminée. Il ne récupère pas une autre page source Douyin.

Les résultats suivent le schéma vidéo et peuvent comprendre l’ID, l’URL, le texte, le contexte public de l’auteur, les médias, la durée, les dates de publication et de collecte, les hashtags, les mentions, l’audio et les nombres visibles de lectures, de mentions J’aime, de commentaires et de partages. Les champs facultatifs peuvent être null ou vides.

Chaque tâche réussie coûte 0,10 crédit SocQ, tarif fixe, quel que soit le nombre d’enregistrements renvoyés par la requête unique au fournisseur.