Instagram Story Highlights

Lists all story highlight albums for an Instagram user.

1 credit / request

GET /v1/instagram/user/highlights Try it

Instagram Story Highlights
GET /v1/instagram/user/highlights

Lists all story highlight albums for an Instagram user.

Authentication: x-api-key
Example URL: https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane

Parameters:
- user_id (query · string · optional) = 2700692569
- handle (query · string · optional) = jane

Overview

WakeScrap exposes this Instagram endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

Lists all story highlight albums for an Instagram user. Each highlight includes its ID, title, cover thumbnail URL, and owner info with username and profile picture. Accepts either a user_id or handle; providing user_id yields faster responses.

Optional query parameters can be combined in a single request.

Headers

x-api-key string required

Your Wake API access key.

Example:

YOUR_API_KEY

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


              curl 'https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/instagram/user/highlights?user_id=2700692569&handle=jane"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "highlights": [
    {
      "__typename": "GraphHighlightReel",
      "id": "18067016518767507",
      "cover_media": {
        "thumbnail_src": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-15/479737232_1405856350793820_7928432152706230890_n.jpg?stp=c0.248.640.640a_dst-jpg_e15_tt6&_nc_ht=scontent-atl3-1.cdninstagram...."
      },
      "cover_media_cropped_thumbnail": {
        "url": "https://scontent-atl3-1.cdninstagram.com/v/t51.2885-15/479737232_1405856350793820_7928432152706230890_n.jpg?stp=c0.202.640.640a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-atl3-1.cdni..."
      },
      "owner": {
        "__typename": "GraphUser",
        "id": "21393171",
        "profile_pic_url": "https://scontent-atl3-2.cdninstagram.com/v/t51.2885-19/482782944_496357423346018_5818268903424754264_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_ht=scontent-atl3-2.cdninstagram.com&_nc_cat=...",
        "username": "jane"
      },
      "title": "GRWM chats"
    }
  ]
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}