/v1/instagram/basic-profile

GET

Basic Profile

Get profile details without posts using a numeric userId. Usually faster than Profile.

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
`userId` Numeric Instagram user ID.	query / optional	`string`
`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/basic-profile' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

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

friendship_statusrequired

null

gatingrequired

null

is_memorializedrequired

boolean

is_privaterequired

boolean

has_story_archiverequired

null

supervision_inforequired

null

is_regulated_c18required

boolean

regulated_news_in_locationsrequired

array

bio_linksrequired

array

linked_fb_inforequired

null

text_post_app_badge_labelrequired

string

show_text_post_app_badgerequired

boolean

usernamerequired

string

text_post_new_post_countrequired

null

pkrequired

string

live_broadcast_visibilityrequired

null

live_broadcast_idrequired

null

profile_pic_urlrequired

string

hd_profile_pic_url_inforequired

object

urlrequired

string

is_unpublishedrequired

boolean

latest_reel_mediarequired

integer

has_profile_picrequired

null

profile_pic_genai_tool_inforequired

array

biographyrequired

string

full_namerequired

string

is_verifiedrequired

boolean

show_account_transparency_detailsrequired

boolean

account_typerequired

integer

follower_countrequired

integer

mutual_followers_countrequired

null

profile_context_links_with_user_idsrequired

null

address_streetrequired

null

city_namerequired

null

is_businessrequired

boolean

ziprequired

null

biography_with_entitiesrequired

object

entitiesrequired

array

categoryrequired

null

should_show_categoryrequired

boolean

account_badgesrequired

array

ai_agent_typerequired

null

external_lynx_urlrequired

null

external_urlrequired

string

pronounsrequired

array

transparency_labelrequired

null

transparency_productrequired

null

has_chainingrequired

null

remove_message_entrypointrequired

null

fbid_v2required

string

is_embeds_disabledrequired

boolean

is_professional_accountrequired

null

following_countrequired

integer

media_countrequired

integer

total_clips_countrequired

integer

latest_besties_reel_mediarequired

null

reel_media_seen_timestamprequired

null

idrequired

string

cachedoptional

boolean

cached_atoptional

string

{
  "format": "date-time"
}

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited