Basic Profile

GET/v1/instagram/basic-profile1 credit

Looks up an account by its numeric user id and returns its profile fields (username, name, bio, counts, profile picture, account type).

01Query parameters

Name	Type	Description
userIdrequired	string	Numeric Instagram user id, e.g. `787132`.
cache_max_ageoptional	string	Accepted for compatibility. Every call is fetched fresh, so any allowed value gives the same live answer; any other value is a free 400.Accepted values:`1d3d7d14d30d`

02Request

curl "https://api.scrapesocial.ai/v1/instagram/basic-profile?userId=787132" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/instagram/basic-profile?userId=787132

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "pk": "787132",
  "aigm_account_label_info": null,
  "friendship_status": null,
  "gating": null,
  "fbid_v2": "17841400573960012",
  "is_memorialized": false,
  "is_private": false,
  "has_story_archive": null,
  "is_coppa_enforced": null,
  "supervision_info": null,
  "is_regulated_c18": false,
  "regulated_news_in_locations": [],
  "bio_links": [
    {
      "image_url": "",
      "is_pinned": false,
      "link_id": "17954981494900183",
      "link_type": "external",
      "lynx_url": "https://l.instagram.com/?u=http%3A%2F%2Fvisitstore.bio%2Fnatgeo&e=AUAg29FyeJ53fs9A-t2ezx6KOeuRrfpc6ovn55_jXdDEnB1TtMXHWpo02STLYrQBH8MZTXr7rZSEGsefdeZZSGpFfg2F2xcIU5PvZfzEiZaq8PkQvMn8_edEATAmyV9XOUyCMdzBktXY7fy9xOF4FIZGjZI",
      "media_accent_color_hex": "",
      "media_type": "none",
      "title": "",
      "url": "http://visitstore.bio/natgeo",
      "creation_source": "NONE"
    },
    {
      "image_url": "",
      "is_pinned": false,
      "link_id": "17908403766429128",
      "link_type": "external",
      "lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fngmdomsubs.nationalgeographic.com%2Fservlet%2FOrdersGateway%3Fcds_mag_code%3DNGM%26cds_page_id%3D283562%26cds_response_key%3DI5FX10002&e=AUAWDE2Arf_D-PhPnxoQSqiJI5U70wFUbeaRz8CIuh8ri9fzcEGEjoMw8Y4cO4o9anRPHGeETdDD-3xmONsuuJ4cmujBF-JDLAZvYwBxSNxrAmB7u8jKFFCrLp_1RrrnTU-BGOdfYAdi8rr_t2KDlvTpeq0",
      "media_accent_color_hex": "",
      "media_type": "none",
      "title": "Subscribe Here!",
      "url": "https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002",
      "creation_source": "NONE"
    }
  ],
  "linked_fb_info": null,
  "meta_verified_benefits_info": {
    "active_meta_verified_benefits": []
  },
  "text_post_app_badge_label": "natgeo",
  "show_text_post_app_badge": true,
  "username": "natgeo",
  "live_broadcast_visibility": null,
  "live_broadcast_id": null,
  "profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=Wrw6QVW6ynMQ7kNvwFBvHcM&_nc_oc=AdreGf603VKz0KsKR05daFopyHJ8tFLlR578qXp6_QToInwag8uD1CTpbIyeR76-4HY&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=GwHOWWL_hABmTj89…",
  "hd_profile_pic_url_info": {
    "url": "https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?_nc_cat=1&ig_cache_key=GAKLvih9nsRnYEVCAJlFVLiBvZt9bmNDAQAB0j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=Wrw6QVW6ynMQ7kNvwFBvHcM&_nc_oc=AdreGf603VKz0KsKR05daFopyHJ8tFLlR578qXp6_QToInwag8uD1CTpbIyeR76-4HY&_nc_zt=24&_nc_ht=scontent.cdninst…"
  },
  "is_unpublished": false,
  "latest_reel_media": null,
  "has_profile_pic": null,
  "profile_pic_genai_tool_info": [],
  "biography": "Step into wonder and find your inner explorer with National Geographic 🌎",
  "full_name": "National Geographic",
  "is_verified": true,
  "show_account_transparency_details": true,
  "account_type": 2,
  "follower_count": 268287575,
  "mutual_followers_count": null,
  "profile_context_links_with_user_ids": null,
  "profile_context_facepile_users": null,
  "address_street": null,
  "city_name": null,
  "is_business": false,
  "zip": null,
  "biography_with_entities": {
    "entities": []
  },
  "category": "",
  "should_show_category": false,
  "is_ring_creator": null,
  "show_ring_award": null,
  "ring_creator_metadata": null,
  "account_badges": [],
  "ai_agent_type": null,
  "external_lynx_url": "https://l.instagram.com/?u=http%3A%2F%2Fvisitstore.bio%2Fnatgeo&e=AUCPRpQUIl-8j3taPKyDjWj5OX_MC_d9AiECPTpHT42G7l5hY06g8LIzyfGnh7y-bcg5QDQg1jgOxjQxQkN9WpLiNofHPTaHn8HHM5oI7r7s5Guwvx4Q3FoAeSsZcIU32vDAbdZ2z34fqPcTxR2NbEdef8c",
  "external_url": "http://visitstore.bio/natgeo",
  "pronouns": [],
  "transparency_label": null,
  "transparency_product": null,
  "hide_creator_marketplace_badge": false,
  "id": "787132",
  "has_chaining": null,
  "remove_message_entrypoint": null,
  "is_embeds_disabled": false,
  "is_cannes": false,
  "is_professional_account": null,
  "following_count": 195,
  "media_count": null,
  "total_clips_count": 1,
  "has_longform_media": false,
  "latest_besties_reel_media": null,
  "reel_media_seen_timestamp": null
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The user fields sit at the top level of the answer, next to `success`. Works for private accounts too. An unknown id is a free 404 whose body also carries `userId` and `notFound: true`; a non-numeric id is a free 400.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.