INSTAGRAM API

Highlights Details

Retrieve highlights details from Instagram with a single API request.

GET/api/data/v1/instagram/user/highlight/detail
1credit base cost

Request parameters

Up to 1 credit

The ID of the highlight to get details for

Try in the console

Live requests use your prepaid balance. Cached responses cost zero where supported.

curl --request GET \
  --url 'https://fetchgoblin.com/api/data/v1/instagram/user/highlight/detail?id=18067016518767507' \
  --header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'

Response

Example
{
  "success": true,
  "can_reshare": true,
  "cover_media": {
    "cropped_image_version": {
      "url": "https://example.com/instagram/highlight-cover.jpg"
    },
    "full_image_version": null
  },
  "id": "highlight:18067016518767507",
  "is_fit_green": true,
  "items": [
    {
      "boost_unavailable_identifier": null,
      "boost_unavailable_reason": null,
      "can_reply": false,
      "can_reshare": true,
      "can_see_insights_as_brand": false,
      "caption": null,
      "code": "DGYvHVDxEzZ",
      "has_audio": true,
      "has_translation": false,
      "id": "3573813516152622297_21393171",
      "ig_media_sharing_disabled": false,
      "image_versions2": {
        "candidates": [
          {
            "height": 1136,
            "url": "https://example.com/instagram/story-3573813516152622297.jpg",
            "width": 640
          }
        ]
      },
      "is_dash_eligible": 1,
      "is_paid_partnership": false,
      "is_story_edited": false,
      "media_overlay_info": null,
      "media_type": 2,
      "number_of_qualities": 4,
      "original_height": 1920,
      "original_width": 1080,
      "pk": "3573813516152622297",
      "product_type": "story",
      "sharing_friction_info": {
        "bloks_app_url": null,
        "should_have_sharing_friction": false
      },
      "story_link_stickers": null,
      "taken_at": 1740251781,
      "user": {
        "id": "21393171",
        "is_private": false,
        "is_verified": true,
        "pk": "21393171",
        "profile_pic_url": "https://example.com/instagram/profile.jpg",
        "username": "jane"
      },
      "video_duration": 47.901,
      "video_versions": [
        {
          "type": 101,
          "url": "https://example.com/instagram/story-3573813516152622297.mp4"
        }
      ]
    }
  ],
  "latest_reel_media": 1752681624,
  "reel_type": "highlight_reel",
  "seen": null,
  "title": "GRWM chats",
  "user": {
    "id": "21393171",
    "interop_messaging_user_fbid": "119713162748634",
    "is_private": false,
    "is_verified": true,
    "pk": "21393171",
    "profile_pic_url": "https://example.com/instagram/profile.jpg",
    "transparency_product_enabled": false,
    "username": "jane"
  },
  "credits_charged": 1,
  "credits_remaining": 1000,
  "request_id": "00000000-0000-4000-8000-000000000000"
}
Illustrative response with example values adapted for FetchGoblin. Run a request to retrieve current platform data.

Response shape

This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.

View JSON Schema +
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "can_reshare": {
      "type": "boolean"
    },
    "cover_media": {
      "type": "object",
      "properties": {
        "cropped_image_version": {
          "type": "object",
          "properties": {
            "url": {
              "type": "string"
            }
          }
        },
        "full_image_version": {
          "type": [
            "string",
            "object",
            "array",
            "number",
            "boolean",
            "null"
          ]
        }
      }
    },
    "id": {
      "type": "string"
    },
    "is_fit_green": {
      "type": "boolean"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "boost_unavailable_identifier": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "boost_unavailable_reason": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "can_reply": {
            "type": "boolean"
          },
          "can_reshare": {
            "type": "boolean"
          },
          "can_see_insights_as_brand": {
            "type": "boolean"
          },
          "caption": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "code": {
            "type": "string"
          },
          "has_audio": {
            "type": "boolean"
          },
          "has_translation": {
            "type": "boolean"
          },
          "id": {
            "type": "string"
          },
          "ig_media_sharing_disabled": {
            "type": "boolean"
          },
          "image_versions2": {
            "type": "object",
            "properties": {
              "candidates": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "height": {
                      "type": "integer"
                    },
                    "url": {
                      "type": "string"
                    },
                    "width": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "is_dash_eligible": {
            "type": "integer"
          },
          "is_paid_partnership": {
            "type": "boolean"
          },
          "is_story_edited": {
            "type": "boolean"
          },
          "media_overlay_info": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "media_type": {
            "type": "integer"
          },
          "number_of_qualities": {
            "type": "integer"
          },
          "original_height": {
            "type": "integer"
          },
          "original_width": {
            "type": "integer"
          },
          "pk": {
            "type": "string"
          },
          "product_type": {
            "type": "string"
          },
          "sharing_friction_info": {
            "type": "object",
            "properties": {
              "bloks_app_url": {
                "type": [
                  "string",
                  "object",
                  "array",
                  "number",
                  "boolean",
                  "null"
                ]
              },
              "should_have_sharing_friction": {
                "type": "boolean"
              }
            }
          },
          "story_link_stickers": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "taken_at": {
            "type": "integer"
          },
          "user": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "is_private": {
                "type": "boolean"
              },
              "is_verified": {
                "type": "boolean"
              },
              "pk": {
                "type": "string"
              },
              "profile_pic_url": {
                "type": "string"
              },
              "username": {
                "type": "string"
              }
            }
          },
          "video_duration": {
            "type": "number"
          },
          "video_versions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "integer"
                },
                "url": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "latest_reel_media": {
      "type": "integer"
    },
    "reel_type": {
      "type": "string"
    },
    "seen": {
      "type": [
        "string",
        "object",
        "array",
        "number",
        "boolean",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "user": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "interop_messaging_user_fbid": {
          "type": "string"
        },
        "is_private": {
          "type": "boolean"
        },
        "is_verified": {
          "type": "boolean"
        },
        "pk": {
          "type": "string"
        },
        "profile_pic_url": {
          "type": "string"
        },
        "transparency_product_enabled": {
          "type": "boolean"
        },
        "username": {
          "type": "string"
        }
      }
    },
    "credits_charged": {
      "type": "integer",
      "minimum": 0,
      "description": "FetchGoblin credits charged for this request."
    },
    "credits_remaining": {
      "type": "integer",
      "description": "Your FetchGoblin credit balance after this request."
    },
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "FetchGoblin request identifier."
    }
  }
}