Skip to main content
GET
/
v1
/
scrape
/
instagram
/
highlights
Story Highlights
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/instagram/highlights \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "highlights": {
      "0": {
        "__typename": "GraphHighlightReel",
        "id": "18154582366360931",
        "cover_media": {
          "thumbnail_src": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-15/558885824_1037483558381763_8621842580080396216_n.jpg?stp=c0.248.640.640a_dst-jpg_e15_tt6&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QGDUXKHGmWNECPXeFhVVRz2AkKg4uiAhr7yA2DxzMlkk51GAJIQ80jHrDUJLzc07z4&_nc_ohc=D81do1QDzBoQ7kNvwHqu-H8&_nc_gid=21r4kTiAHVWEhGSRib5uBg&edm=AGW0Xe4BAAAA&ccb=7-5&oh=00_AfsWJHKHzysbhvJumkoAnG8EnSZebaswWYYDowHuXDaePw&oe=698ECEBF&_nc_sid=94fea1"
        },
        "cover_media_cropped_thumbnail": {
          "url": "https://scontent-sea1-1.cdninstagram.com/v/t51.2885-15/561153419_788861093997661_8633888304726742947_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-sea1-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2QGDUXKHGmWNECPXeFhVVRz2AkKg4uiAhr7yA2DxzMlkk51GAJIQ80jHrDUJLzc07z4&_nc_ohc=3kEPQhWB604Q7kNvwG9dnzb&_nc_gid=21r4kTiAHVWEhGSRib5uBg&edm=AGW0Xe4BAAAA&ccb=7-5&oh=00_AfvPl3rF3eB3QW3cQSZ6qdrtr0y8NP9Ht-awjE70PxjjQQ&oe=698EE729&_nc_sid=94fea1"
        },
        "owner": {
          "__typename": "GraphUser",
          "id": "21393171",
          "profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/629783272_18551475079017172_5737125966880342474_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2QGDUXKHGmWNECPXeFhVVRz2AkKg4uiAhr7yA2DxzMlkk51GAJIQ80jHrDUJLzc07z4&_nc_ohc=xqKumIqBCNIQ7kNvwEmGFTN&_nc_gid=21r4kTiAHVWEhGSRib5uBg&edm=AGW0Xe4BAAAA&ccb=7-5&oh=00_AfsjMnOm5YTh8amnBwG1qc-yVhc-ds5ZU17RUCjEz6WrTg&oe=698EEC56&_nc_sid=94fea1",
          "username": "jane"
        },
        "title": "BOB hairstyles💇‍♀️"
      }
    }
  },
  "credits_used": 1,
  "endpoint": "instagram/highlights"
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
user_id
string

Instagram user id. Use for faster response times.

Example:

"2700692569"

​
handle
string

Instagram handle. Use user_id for faster response times.

Example:

"jane"

Response

Successful response

Key Response Fields:

  • data.highlights[0].id: Unique highlight reel ID — pass to the highlight-detail endpoint to get the stories
  • data.highlights[0].title: Display title of the highlight reel
  • data.highlights[0].cover_media.thumbnail_src: Cover image thumbnail URL
  • data.highlights[0].cover_media_cropped_thumbnail.url: Cropped cover thumbnail URL
  • data.highlights[0].owner.id: Owner's Instagram user ID
  • data.highlights[0].owner.username: Owner's Instagram username