/v1/instagram/profile

GET

Profile

Get public profile details, recent posts, and related accounts. Private profiles return public details only. Pinned-post metadata is not reliably available; returned order does not identify pins.

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 support	Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`handle` Instagram handle	query / required	`string`
`trim` Set to true for a trimmed response.	query / optional	`boolean`
`cache_max_age` Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.	query / optional	`string` Allowed values `["1d","3d","7d","14d","30d"]`

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/profile?handle=YOUR_HANDLE' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/instagram/profile?handle=YOUR_HANDLE", {
  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/profile?handle=YOUR_HANDLE",
    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

datarequired

object

userrequired

object

ai_agent_typeoptional

null

biographyrequired

string

bio_linksrequired

array

Array items

object

titlerequired

string

lynx_urlrequired

string

urlrequired

string

link_typerequired

string

image_urloptional

string

is_pinnedoptional

boolean

link_idoptional

string

media_accent_color_hexoptional

string

media_typeoptional

string

creation_sourceoptional

string

fb_profile_biolinkoptional

null

biography_with_entitiesrequired

object

raw_textoptional

string

entitiesrequired

array

blocked_by_vieweroptional

boolean

restricted_by_vieweroptional

null

country_blockoptional

boolean

eimu_idoptional

string

external_urlrequired

string

external_url_linkshimmedoptional

string

edge_followed_byrequired

object

countrequired

integer

fbidoptional

string

followed_by_vieweroptional

boolean

edge_followrequired

object

countrequired

integer

follows_vieweroptional

boolean

full_namerequired

string

group_metadataoptional

null

has_ar_effectsoptional

boolean

has_clipsoptional

boolean

has_guidesoptional

boolean

has_channeloptional

boolean

has_blocked_vieweroptional

boolean

highlight_reel_countoptional

integer

has_onboarded_to_text_post_appoptional

boolean

has_requested_vieweroptional

boolean

hide_like_and_view_countsoptional

boolean

idrequired

string

is_business_accountrequired

boolean

is_professional_accountrequired

boolean

is_supervision_enabledoptional

boolean

is_guardian_of_vieweroptional

boolean

is_supervised_by_vieweroptional

boolean

is_supervised_useroptional

boolean

is_embeds_disabledoptional

boolean

is_joined_recentlyoptional

boolean

guardian_idoptional

null

business_address_jsonrequired

schema

anyOf

schema

anyOf

schema

anyOf

schema

anyOf

string

anyOf

object

city_namerequired

string

city_idrequired

integer

latituderequired

number

longituderequired

number

street_addressrequired

null

zip_coderequired

null

anyOf

string

anyOf

object

anyOf

object

business_contact_methodoptional

string

business_emailoptional

null

business_phone_numberoptional

null

business_category_nameoptional

string

overall_category_nameoptional

null

category_enumoptional

null

category_namerequired

string

is_privaterequired

boolean

is_verifiedrequired

boolean

is_verified_by_mv4boptional

boolean

is_regulated_c18optional

boolean

edge_mutual_followed_byoptional

object

countrequired

integer

edgesrequired

array

pinned_channels_list_countoptional

integer

profile_pic_urlrequired

string

profile_pic_url_hdrequired

string

requested_by_vieweroptional

boolean

should_show_categoryoptional

boolean

should_show_public_contactsoptional

boolean

show_account_transparency_detailsoptional

boolean

show_text_post_app_badgeoptional

boolean

remove_message_entrypointoptional

boolean

transparency_labeloptional

null

transparency_productoptional

null

usernamerequired

string

connected_fb_pageoptional

null

pronounsoptional

array

edge_felix_video_timelineoptional

object

countrequired

integer

page_inforequired

object

has_next_pagerequired

boolean

end_cursorrequired

null

edgesrequired

array

edge_owner_to_timeline_mediaoptional

object

countrequired

integer

page_inforequired

object

has_next_pagerequired

boolean

end_cursorrequired

string

edgesrequired

array

Array items

object

noderequired

object

__typenamerequired

string

idrequired

string

shortcoderequired

string

dimensionsrequired

object

heightrequired

integer

widthrequired

integer

display_urlrequired

string

edge_media_to_tagged_userrequired

object

edgesrequired

array

Array items

object

noderequired

object

idrequired

string

xrequired

number

yrequired

number

userrequired

object

idrequired

string

usernamerequired

string

is_verifiedrequired

boolean

profile_pic_urlrequired

string

full_namerequired

string

fact_check_overall_ratingoptional

null

fact_check_informationoptional

null

gating_infooptional

null

sharing_friction_infooptional

object

should_have_sharing_frictionrequired

boolean

bloks_app_urlrequired

null

media_overlay_infooptional

null

media_previewoptional

string

ownerrequired

object

idrequired

string

usernamerequired

string

is_verifiedoptional

boolean

profile_pic_urloptional

string

full_nameoptional

string

edge_followed_byoptional

object

countrequired

integer

is_videorequired

boolean

has_upcoming_eventoptional

boolean

accessibility_captionoptional

null

has_audiorequired

boolean

tracking_tokenoptional

string

video_urlrequired

string

video_view_countoptional

integer

edge_media_to_captionrequired

object

edgesrequired

array

Array items

object

noderequired

object

idrequired

string

textrequired

string

created_atrequired

string

edge_media_to_commentrequired

object

countrequired

integer

page_infooptional

object

has_next_pagerequired

boolean

end_cursorrequired

null

edgesoptional

array

comments_disabledrequired

boolean

taken_at_timestamprequired

integer

edge_liked_byoptional

object

countrequired

integer

edge_media_preview_likerequired

object

countrequired

integer

edgesoptional

array

locationrequired

null

nft_asset_infooptional

null

thumbnail_srcrequired

string

thumbnail_resourcesrequired

array

Array items

object

srcrequired

string

config_widthrequired

integer

config_heightrequired

integer

felix_profile_grid_cropoptional

null

coauthor_producersrequired

array

Array items

object

__typenamerequired

string

strong_id__required

string

idrequired

null

full_namerequired

string

is_privaterequired

boolean

is_verifiedrequired

boolean

profile_pic_idrequired

string

profile_pic_urlrequired

string

usernamerequired

string

user_activation_inforequired

null

pkrequired

string

friendship_statusrequired

null

is_unpublishedrequired

null

supervision_inforequired

null

viewer_can_reshareoptional

boolean

like_and_view_counts_disabledrequired

boolean

product_typerequired

string

clips_music_attribution_inforequired

object

artist_namerequired

string

song_namerequired

string

uses_original_audiorequired

boolean

should_mute_audiorequired

boolean

should_mute_audio_reasonrequired

string

audio_idrequired

string

dash_infooptional

object

is_dash_eligiblerequired

boolean

video_dash_manifestrequired

string

number_of_qualitiesrequired

integer

thumbnail_tall_srcoptional

string

tall_profile_grid_cropoptional

null

profile_grid_thumbnail_fitting_styleoptional

string

__isXDTGraphMediaInterfaceoptional

string

video_durationoptional

number

created_atoptional

string

{
  "format": "date-time"
}

comment_countoptional

integer

edge_media_preview_commentoptional

object

countrequired

integer

edgesrequired

array

edge_media_to_parent_commentoptional

object

countrequired

integer

edgesrequired

array

edge_sidecar_to_childrenoptional

object

edgesrequired

array

Array items

object

noderequired

object

__typenamerequired

string

idrequired

string

shortcoderequired

string

display_urlrequired

string

video_urlrequired

string

is_videorequired

boolean

dimensionsrequired

object

heightrequired

integer

widthrequired

integer

video_durationoptional

number

clips_metadataoptional

object

originality_inforequired

null

__rt_3c4e8bb6a59drequired

string

achievements_inforequired

object

num_earned_achievementsrequired

null

show_achievementsrequired

boolean

additional_audio_inforequired

object

additional_audio_usernamerequired

null

audio_reattribution_inforequired

object

should_allow_restorerequired

boolean

audio_ranking_inforequired

object

best_audio_cluster_idrequired

null

audio_typerequired

string

branded_content_tag_inforequired

object

can_add_tagrequired

boolean

clips_creation_entry_pointrequired

string

content_appreciation_inforequired

object

enabledrequired

boolean

entry_point_containerrequired

null

contextual_highlight_inforequired

null

disable_use_in_clips_client_cacherequired

boolean

is_fan_club_promo_videorequired

null

is_public_chat_welcome_videorequired

boolean

is_shared_to_fbrequired

boolean

mashup_inforequired

object

can_toggle_mashups_allowedrequired

boolean

has_been_mashed_uprequired

boolean

has_nonmimicable_additional_audiorequired

boolean

is_creator_requesting_mashuprequired

boolean

is_light_weight_checkrequired

boolean

is_pivot_page_availablerequired

boolean

mashup_typerequired

null

mashups_allowedrequired

boolean

non_privacy_filtered_mashups_media_countrequired

integer

original_mediarequired

null

merchandising_pill_inforequired

null

music_canonical_idrequired

string

music_inforequired

null

original_sound_inforequired

object

allow_creator_to_renamerequired

boolean

audio_asset_idrequired

string

audio_filter_infosrequired

array

audio_partsrequired

array

audio_parts_by_filterrequired

array

can_remix_be_shared_to_fbrequired

boolean

can_remix_be_shared_to_fb_expansionrequired

boolean

consumption_inforequired

object

is_bookmarkedrequired

boolean

is_trending_in_clipsrequired

boolean

should_mute_audio_reasonrequired

string

should_mute_audio_reason_typerequired

null

dash_manifestrequired

string

duration_in_msrequired

integer

hide_remixingrequired

boolean

ig_artistrequired

object

__typenamerequired

string

strong_id__required

string

idrequired

string

full_namerequired

string

is_privaterequired

boolean

is_verifiedrequired

boolean

profile_pic_idrequired

string

profile_pic_urlrequired

string

usernamerequired

string

is_audio_automatically_attributedrequired

boolean

is_eligible_for_audio_effectsrequired

boolean

is_explicitrequired

boolean

is_original_audio_download_eligiblerequired

boolean

oa_owner_is_music_artistrequired

boolean

is_reuse_disabledrequired

boolean

is_xpost_from_fbrequired

boolean

original_audio_subtyperequired

string

original_audio_titlerequired

string

original_media_idrequired

string

progressive_download_urlrequired

string

should_mute_audiorequired

boolean

time_createdrequired

integer

fb_downstream_use_xpost_metadatarequired

object

downstream_use_xpost_deny_reasonrequired

string

professional_clips_upsell_typerequired

integer

shopping_inforequired

null

show_achievementsrequired

boolean

is_adoptional

boolean

is_paid_partnershipoptional

boolean

ai_label_infooptional

object

attribution_label_textrequired

string

content_sheet_sectionsrequired

array

gen_ai_detection_methodrequired

string

subtitle_textrequired

string

display_resourcesoptional

array

Array items

object

srcrequired

string

config_widthrequired

integer

config_heightrequired

integer

urloptional

string

video_play_countoptional

integer

edge_saved_mediaoptional

object

countrequired

integer

page_inforequired

object

has_next_pagerequired

boolean

end_cursorrequired

null

edgesrequired

array

edge_media_collectionsoptional

object

countrequired

integer

page_inforequired

object

has_next_pagerequired

boolean

end_cursorrequired

null

edgesrequired

array

edge_related_profilesoptional

object

edgesrequired

array

Array items

object

noderequired

object

idrequired

string

full_namerequired

string

is_privaterequired

boolean

is_verifiedrequired

boolean

profile_pic_urlrequired

string

usernamerequired

string

ai_agent_owner_usernameoptional

null

statusoptional

string

cachedoptional

boolean

cached_atoptional

string

{
  "format": "date-time"
}

handleoptional

string

userIdoptional

null

erroroptional

string

errorStatusoptional

integer

messageoptional

string

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited