Stories eines Instagram-Creators (Echtzeit)

Holt die zur Anfragezeit aktiven Stories eines Instagram-Creators. Stories laufen nach 24 Stunden ab, daher gibt es diesen Endpunkt nur in Echtzeit; er verbraucht mehr Kontingent als Datenbankabrufe.

GET/api/v1/instagram/realtime/user/stories

Kontingentverbrauch: Jede erfolgreiche Anfrage an diesen Endpunkt zieht 100 Kontingenteinheiten von Ihrem Plan ab.

Request-Parameter

Pflichtparameter

Name	Ort	Typ	Beschreibung
`user_id`	query	string	user_id example: 13460080

Antwortfelder

Name	Typ	Beschreibung
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.user`	object	user
`data.stories`	array<object>	stories

Ausprobieren

Anfrage-URL

https://openapi.scdata.cc/api/v1/instagram/realtime/user/stories

Authorization

API-Schlüssel aus dem Dashboard auswählen

Fügen Sie einen API-Schlüssel hinzu, bevor Sie eine Anfrage senden.Zum Dashboard

Query-Parameter

user_id*

cURL-Beispiel

bash

curl -X GET "https://openapi.scdata.cc/api/v1/instagram/realtime/user/stories?user_id=13460080" \
  -H "Authorization: YOUR_API_KEY"

Antwortbeispiel (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
          }
        ]
      }
    ]
  }
}

Anwendungsfälle

Story-Lieferung prüfen — Bestätigen Sie, dass eine gesponserte Story im vereinbarten Zeitfenster veröffentlicht wurde, bevor sie verschwindet.
Link-Platzierung prüfen — Prüfen Sie, ob der Tracking-Link oder Produkt-Sticker in der Story enthalten war.