Instagram Stories API

Get the stories currently available on a public Instagram profile, including media variants, publish and expiration times, author details, mentions, links and shared posts. Returns an empty stories list when none are available. Stories are not paginated.

Endpoint: POST /instagram/stories
Price: 1 credit per request
SDK: client.instagram.getStories()
MCP tool: instagram_stories

Start free with 100 credits Read docs →

Terminal

$curl -X POST "https://api.bridgly.app/instagram/stories" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "username": "instagram"
}'

request.py

import os
import requests
response = requests.post(
    "https://api.bridgly.app/instagram/stories",
    headers={"Authorization": f"Bearer {os.environ['BRIDGLY_KEY']}"},
    json={
        "username": "instagram",
    },
)
data = response.json()

request.js

const response = await fetch("https://api.bridgly.app/instagram/stories", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BRIDGLY_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "username": "instagram"
  }),
});
const data = await response.json();

request.ts

import { Bridgly } from "@bridgly/sdk";
const client = new Bridgly({ apiKey: "bgly_YOUR_KEY" });
const res = await client.instagram.getStories({
  username: "instagram"
});
if (res.type === "success") {
  console.log(res.data);
}

[ REQUEST AND RESPONSE ]

What does the Instagram Stories API return?

Get a public Instagram account’s current Stories as JSON, with image and video links, publish and expiration times, dimensions and duration. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

usernamestringrequired: Instagram username, or the profile link, e.g. "instagram" or "https://www.instagram.com/instagram/"

Example response

200 OK · application/json

{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "stories": [
      {
        "id": "string",
        "display_url": "string",
        "video_url": "string",
        "width": 0,
        "height": 0,
        "video_duration": 0,
        "accessibility_caption": "string",
        "image_versions": [
          {
            "url": "string",
            "width": 0,
            "height": 0
          }
        ],
        "video_versions": [
          {
            "url": "string",
            "width": 0,
            "height": 0,
            "type": 0
          }
        ],
        "has_audio": true,
        "video_dash_manifest": "string",
        "number_of_qualities": 0,
        "shortcode": "string",
        "url": "string",
        "type": "Image",
        "owner": {
          "id": "string",
          "username": "string",
          "full_name": "string",
          "profile_pic_url": "string",
          "is_private": true,
          "is_verified": true,
          "profile_pic_id": "string",
          "latest_reel_media": 0,
          "is_mentionable": true
        },
        "is_edited": true,
        "is_paid_partnership": true,
        "mentions": [
          {
            "username": "string",
            "full_name": "string"
          }
        ],
        "links": [
          "string"
        ],
        "shared_posts": [
          {
            "shortcode": "string",
            "url": "string",
            "product_type": "string"
          }
        ],
        "music": [
          {
            "title": "string",
            "artist": "string"
          }
        ],
        "timestamp": 0,
        "expires_at": 0,
        "caption": "string"
      }
    ]
  }
}

[ USE CASES ]

What can you build with the Instagram Stories API?

Monitor campaigns

Check the current stories on a public brand profile.

Collect story media

Get image and video links before a story expires.

Track publishing

Record when a public account publishes stories.

[ FAQ ]

Instagram Stories API questions

How do I use the Instagram Stories API?

Send a POST request to https://api.bridgly.app/instagram/stories with username in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.instagram.getStories(). AI agents connected to Bridgly over MCP can call the instagram_stories tool.

How much does the Instagram Stories API cost?

Costs 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More Instagram endpoints

The same API key works on every endpoint. See all Instagram API endpoints.

Try the Instagram Stories API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI

free credits

On business email signup. No credit card required.

Start free with 100 credits

Book a demo Read the docs