Get stories

curl "https://api.instagramapi.dev/v1/profile/stories?handle=nike" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/profile/stories?handle=nike", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/profile/stories?handle=nike",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

{
  "data": {
    "items": [
      {
        "id": "3925236392186180177",
        "shortcode": "DZxabc12345",
        "type": "video",
        "taken_at": "2026-06-23T18:02:11Z",
        "image_url": "https://instagram.com/.../story.jpg",
        "video_url": "https://instagram.com/.../story.mp4",
        "video_duration": 14.2
      }
    ],
    "next_cursor": null
  },
  "meta": {
    "endpoint": "profile/stories",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 2,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"handle\".",
    "docs": "/docs/profile/stories"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/profile/stories"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "profile/stories",
    "credits_charged": 2,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/profile/stories"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}