fetchproof.

/v1/instagram/user/highlight/detail

GET

Highlights Details

Get a highlight's stories from Instagram's public web source. Legacy metadata such as created_at, media_count and media_ids is omitted; other metadata can be missing.

Credit cost

Default: 1 credit

How charges are determined

Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.

A call that fails costs 0 credits. A result served from cache costs 0 credits.

`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.

A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).

A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.

Cache supportNot specified in the published contract.
PaginationNo explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

NameLocation / requiredSchema
id

Story highlight ID.

query / optional

string

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL
curl --request GET 'https://api.fetchproof.com/v1/instagram/user/highlight/detail' \
  --header 'x-api-key: YOUR_API_KEY'
JavaScript
const response = await fetch("https://api.fetchproof.com/v1/instagram/user/highlight/detail", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());
Python
import os
import requests

response = requests.get("https://api.fetchproof.com/v1/instagram/user/highlight/detail",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

can_resharerequired

boolean

cover_mediarequired

object

cropped_image_versionrequired

object

urlrequired

string

full_image_versionrequired

null

idrequired

string

is_fit_greenrequired

boolean

itemsrequired

array

Array items

object

boost_unavailable_identifierrequired

null

boost_unavailable_reasonrequired

null

can_replyrequired

boolean

can_resharerequired

boolean

can_see_insights_as_brandrequired

boolean

captionrequired

null

coderequired

string

has_audiorequired

boolean

has_translationrequired

boolean

idrequired

string

ig_media_sharing_disabledrequired

boolean

image_versions2required

object

candidatesrequired

array

Array items

object

heightrequired

integer

urlrequired

string

widthrequired

integer

is_dash_eligiblerequired

integer

is_paid_partnershiprequired

boolean

is_story_editedrequired

boolean

media_overlay_inforequired

null

media_typerequired

integer

number_of_qualitiesrequired

integer

original_heightrequired

integer

original_widthrequired

integer

pkrequired

string

product_typerequired

string

sharing_friction_inforequired

object

bloks_app_urlrequired

null

should_have_sharing_frictionrequired

boolean

story_link_stickersrequired

array

Array items

object

heightrequired

number

idrequired

string

rotationrequired

integer

story_linkrequired

object

urlrequired

string

widthrequired

number

xrequired

number

yrequired

number

taken_atrequired

integer

userrequired

object

idrequired

string

is_privaterequired

boolean

is_verifiedrequired

boolean

pkrequired

string

profile_pic_urlrequired

string

usernamerequired

string

video_durationrequired

number

video_versionsrequired

array

Array items

object

typerequired

integer

urlrequired

string

latest_reel_mediarequired

integer

reel_typerequired

string

seenrequired

null

titlerequired

string

userrequired

object

idrequired

string

interop_messaging_user_fbidrequired

string

is_privaterequired

boolean

is_verifiedrequired

boolean

pkrequired

string

profile_pic_urlrequired

string

transparency_product_enabledrequired

boolean

usernamerequired

string

401Invalid or missing x-api-key
402No credits remaining
403Upstream denied (age gate, audience controls)
404Resource or endpoint not found
429Rate limited