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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Requê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.
- Choisissez une requête texte précise qui décrit les vidéos publiques que vous souhaitez découvrir.
- Envoyez query en POST à /v1/douyin/video-search et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- 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 onlyCas 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.
API associées
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.
- Douyin Live Room Detail API — Récupérez un live Douyin connu à partir de son ID numérique de salle avec contexte normalisé, identité de l’hôte, médias et nombres d’audience visibles.
- Douyin User Profile API
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API