API Direct

Instagram User Highlights

GET /v1/instagram/user/highlights

Get a user's story highlights by username or profile URL. Returns each highlight's ID, title, story count, cover image, and created / updated dates. Use the highlight ID with the Highlight Stories endpoint to get the stories inside.

Cost

$0.006 per request

Free tier

50 requests/month

Parameters

username

Instagram username, with or without leading @ (max 100 characters). Provide either username or url.

url

Instagram profile URL, e.g. https://instagram.com/natgeo (max 500 characters). Provide either username or url.

Example Request

curl "https://apidirect.io/v1/instagram/user/highlights?username=mrbeast" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/instagram/user/highlights",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "username": "mrbeast"
    }
)
print(response.json())

Example Response

{
  "highlights": [
    {
      "highlight_id": "17929440964811872",
      "title": "Operation Chad",
      "media_count": 14,
      "cover_url": "https://scontent.cdninstagram.com/v/t51.82787-15/cover.jpg",
      "created_at": "2021-12-01 21:15:33",
      "created_at_timestamp": 1638393333,
      "updated_at": "2025-08-09 03:54:16",
      "updated_at_timestamp": 1754706856,
      "is_pinned": false,
      "url": "https://instagram.com/stories/highlights/17929440964811872/",
      "author": "mrbeast",
      "author_id": "2278169415"
    }
  ],
  "username": "mrbeast",
  "count": 9
}

Your Usage

Free tier this month

Recent Activity