Récupère les stories en ligne d'un créateur Instagram au moment de la requête. Les stories expirant au bout de 24 heures, cet endpoint est uniquement temps réel et consomme plus de quota qu'une lecture en base.
GET
/api/v1/instagram/realtime/user/storiesConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 100 unités de quota de votre forfait.
Paramètres de requête
Paramètres obligatoires
| Nom | Emplacement | Type | Description |
|---|---|---|---|
user_id | query | string | user_id example: 13460080 |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.user | object | user |
data.stories | array<object> | stories |
Tester
https://openapi.scdata.cc/api/v1/instagram/realtime/user/stories
Sélectionnez une clé API du tableau de bord
Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord
Paramètres de requête
user_id*Exemple cURL
bash
curl -X GET "https://openapi.scdata.cc/api/v1/instagram/realtime/user/stories?user_id=13460080" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"user": {"user_id": "string","username": "string","full_name": "string","is_private": true,"is_verified": true,"avatar": "string"},"stories": [{"media_id": "string","media_code": "string","create_at": "2019-08-24T14:15:22.123Z","expiring_at": "2019-08-24T14:15:22.123Z","media_type": 0,"cover_url": "string","video_url": "string","video_duration": "string","mention_users": [{"user_id": "string","username": "string","full_name": "string","is_private": true,"is_verified": true,"avatar": "string"}],"locations": [{"location_id": "string","name": "string","address": "string","city": "string","latitude": 0,"longitude": 0}]}]}}
Cas d'usage
- Vérification de livrable story — Confirmez qu'une story sponsorisée a été publiée dans le créneau convenu avant qu'elle ne disparaisse.
- Audit de placement de liens — Vérifiez que le lien de suivi ou le sticker produit figure bien dans la story.