Longues vidéos chinoises à faible abonnement
Un classement d'opportunité dédié qui renvoie les éléments stricts par défaut.
GET
https://api.shortsmonkey.com/v1/rankings/chinese-low-subscriber-long-videos?start_date=2026-07-01&end_date=2026-07-20&quality=strict&limit=201 crédit pour 1 à 20 articles réels
Longues vidéos chinoises à faible abonnement#
Un classement d'opportunité dédié qui renvoie les éléments stricts par défaut.
Authentification#
Envoyez Authorization: Bearer sm_live_.... Ne placez jamais la clé complète dans les URL, les cookies, les corps, les journaux ou les analyses.
Fraîcheur des données#
Les classements lisent les instantanés stables publiés par le travailleur. Les lectures publiques ne déclenchent jamais une actualisation YouTube.
Demande#
| Article | Valeur | Description |
|---|---|---|
| Méthode | GET | Méthode de requête HTTP |
| Complet URL | https://api.shortsmonkey.com/v1/rankings/chinese-low-subscriber-long-videos?start_date=2026-07-01&end_date=2026-07-20&quality=strict&limit=20 | Production API URL |
| Authentification | Authorization: Bearer sm_live_... | Envoyer la clé complète uniquement dans l'en-tête |
| Type de contenu | Aucun corps de requête | Les requêtes GET n'ont pas de corps de requête |
| Crédits | 1 crédit pour 1 à 20 articles réels | Les réponses aux erreurs coûtent 0 crédit |
Paramètres de la demande#
| Nom | Emplacement | Taper | Requis | Défaut | Valeurs ou limites | Description |
|---|---|---|---|---|---|---|
period | Requête | string | Non | today | today / 7d / all_time | Fenêtre de publication prédéfinie ; omettre lors de l'utilisation de dates personnalisées |
start_date | Requête | string(date) | Conditionnel | — | YYYY-MM-DD | Date de début UTC incluse ; doit être associé à end_date |
end_date | Requête | string(date) | Conditionnel | — | YYYY-MM-DD | Date de fin UTC incluse ; ne peut pas être antérieur à la date de début |
track | Requête | string | Non | all | 1 à 80 caractères | Filtrer par identifiant de piste ; all inclut chaque piste |
quality | Requête | string | Non | strict | strict / all | Renvoie uniquement des données strictes ou inclut des candidats étendus |
limit | Requête | integer | Non | 20 | 1–50 | Nombre maximum d'éléments sur cette page |
all_cursor | Requête | string | Non | — | all_data.next_cursor, valable 24 heures | Récupérer la page suivante non filtrée |
filter_cursor | Requête | string | Non | — | filter_data.next_cursor, valable 24 heures | Récupérer la page filtrée suivante sans changer les filtres |
cursor | Requête | string | Non | — | Paramètre de compatibilité obsolète | Alias pour filter_cursor ; n'envoyez pas les deux |
Champs de réponse de réussite#
all_data est une page non filtrée de l'instantané stable ; filter_data est une page du même instantané après les paramètres par défaut du point de terminaison et les filtres de demande. Chaque résultat est paginé indépendamment.
La notation par points représente les objets imbriqués et [] représente les éléments du tableau. Le nombre d'abonnés inconnus est null avec subscriber_count_hidden: true. Une demande est facturée une seule fois en utilisant le plus grand nombre d'articles retournés, jamais la somme des deux ensembles.
| Chemin de champ | Taper | Nullable | Description |
|---|---|---|---|
data.all_data.items | array<object> | Non | Éléments vidéo non filtrés sur la page actuelle |
data.all_data.items[].video_id | string | Non | ID vidéo YouTube |
data.all_data.items[].title | string | Non | Titre de la vidéo |
data.all_data.items[].video_url | string | Non | Vidéo YouTube URL |
data.all_data.items[].channel.id | string | Oui | ID de chaîne |
data.all_data.items[].channel.title | string | Non | Titre de la chaîne |
data.all_data.items[].channel.subscribers | integer | Oui | Nombre d'abonnés ; null lorsqu'il est masqué |
data.all_data.items[].channel.subscriber_count_hidden | boolean | Non | Si le nombre d'abonnés est masqué |
data.all_data.items[].views | integer | Non | Instantané du nombre de vues |
data.all_data.items[].views_to_subscribers_ratio | number | Oui | Ratio vues/abonnés |
data.all_data.items[].opportunity_score | number | Oui | Score d'opportunité |
data.all_data.items[].duration_seconds | integer | Non | Durée de la vidéo en secondes |
data.all_data.items[].published_at | string(date-time) | Oui | Heure de publication de la vidéo en UTC ISO 8601 |
data.all_data.items[].snapshot_at | string(date-time) | Oui | Temps de collecte des données |
data.all_data.items[].niche | string | Oui | Niche ou catégorie |
data.all_data.items[].track | string | Oui | Identifiant de la piste de l'ensemble de données |
data.all_data.items[].region | string | Oui | Code de région |
data.all_data.items[].reasons | array<string> | Non | Raisons du classement |
data.all_data.items[].video_type | string | Non | shorts ou long |
data.all_data.next_cursor | string | Oui | Page suivante cursor pour cet ensemble de résultats ; null une fois terminé |
data.filter_data.items | array<object> | Non | Éléments vidéo après les valeurs par défaut et les filtres de demande |
data.filter_data.items[].video_id | string | Non | ID vidéo YouTube |
data.filter_data.items[].title | string | Non | Titre de la vidéo |
data.filter_data.items[].video_url | string | Non | Vidéo YouTube URL |
data.filter_data.items[].channel.id | string | Oui | ID de chaîne |
data.filter_data.items[].channel.title | string | Non | Titre de la chaîne |
data.filter_data.items[].channel.subscribers | integer | Oui | Nombre d'abonnés ; null lorsqu'il est masqué |
data.filter_data.items[].channel.subscriber_count_hidden | boolean | Non | Si le nombre d'abonnés est masqué |
data.filter_data.items[].views | integer | Non | Instantané du nombre de vues |
data.filter_data.items[].views_to_subscribers_ratio | number | Oui | Ratio vues/abonnés |
data.filter_data.items[].opportunity_score | number | Oui | Score d'opportunité |
data.filter_data.items[].duration_seconds | integer | Non | Durée de la vidéo en secondes |
data.filter_data.items[].published_at | string(date-time) | Oui | Heure de publication de la vidéo en UTC ISO 8601 |
data.filter_data.items[].snapshot_at | string(date-time) | Oui | Temps de collecte des données |
data.filter_data.items[].niche | string | Oui | Niche ou catégorie |
data.filter_data.items[].track | string | Oui | Identifiant de la piste de l'ensemble de données |
data.filter_data.items[].region | string | Oui | Code de région |
data.filter_data.items[].reasons | array<string> | Non | Raisons du classement |
data.filter_data.items[].video_type | string | Non | shorts ou long |
data.filter_data.next_cursor | string | Oui | Page suivante cursor pour cet ensemble de résultats ; null une fois terminé |
data.all_data.items[].quality_tier | string | Non | strict ou expanded |
data.filter_data.items[].quality_tier | string | Non | strict ou expanded |
data.all_data.items[].is_expanded_candidate | boolean | Non | Si l'élément est un candidat étendu |
data.filter_data.items[].is_expanded_candidate | boolean | Non | Si l'élément est un candidat étendu |
meta.methodology_version | string | Non | Version méthodologie de classement |
meta.request_id | string | Non | Demander l'ID de trace |
meta.snapshot_id | string | Non | ID d'instantané stable |
meta.snapshot_at | string(date-time) | Non | Horodatage de l'instantané |
meta.data_status | string | Non | Statut de l'ensemble de données |
credits.cost | integer | Non | Crédits réels facturés |
credits.remaining | integer | Non | Crédits de compte restants |
credits.period_ends_at | string(date-time) | Non | Fin de la période de crédit en cours |
Pagination et cursor#
Envoyez all_data.next_cursor sous la forme all_cursor et filter_data.next_cursor sous la forme filter_cursor. Les cursor sont indépendants, opaques, signés et valables 24 heures ; l'ancien cursor n'est qu'un alias pour filter_cursor.
Etag#
Les classements prennent en charge If-None-Match. Un hit renvoie HTTP 304 avec X-Credits-Cost: 0.
Erreurs et limites de débit#
Chaque erreur contient code, l'anglais stable message, request_id et details. Toutes les réponses 4xx/5xx ne coûtent aucun crédit.
| Statut HTTP | Code | Cause | Action suggérée |
|---|---|---|---|
| 400 | INVALID_REQUEST | Format, combinaison ou plage de paramètre non valide | Corrigez les paramètres à l'aide de details.issues |
| 401 | INVALID_API_KEY | La clé est invalide ou inactive | Vérifiez l’en-tête Bearer et l’état de la clé |
| 402 | SUBSCRIPTION_REQUIRED / CREDITS_EXHAUSTED | L'abonnement ou les crédits ne sont pas disponibles | Vérifiez le plan, le solde et le budget de sécurité clé |
| 429 | RATE_LIMITED | Limite de débit ou de simultanéité dépassée | Réessayez après l'intervalle Retry-After |
| 503 | DATA_STALE / SERVICE_UNAVAILABLE | Les données ou le service sont temporairement indisponibles | Réessayez plus tard et conservez request_id |
curl -X GET "https://api.shortsmonkey.com/v1/rankings/chinese-low-subscriber-long-videos?start_date=2026-07-01&end_date=2026-07-20&quality=strict&limit=20" \
-H "Authorization: Bearer $SHORTSMONKEY_API_KEY"