Instagram APIs - User Details (V1)
Retrieves public profile information of an Instagram user, including follower count, following count, post count, and basic profile details.
Typical use cases:
- Obtaining basic account metadata for influencer vetting
- Tracking follower growth and audience reach over time
- Mapping user handles to specific profile stats
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | Access token for the API service. |
username | query | string | Yes | The Instagram username whose profile details are to be retrieved. |
Code Samples
💡 Environment Note
Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.
bash
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/instagram/get-user-detail/v1?token=YOUR_API_KEY&username=VALUE"text
I want to use the "User Details (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/instagram/get-user-detail/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/instagram-apis/user-details-v1-en.json
Parameters:
- token (query): Access token for the API service. (Required)
- username (query): The Instagram username whose profile details are to be retrieved. (Required)
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/instagram/get-user-detail/v1?token=YOUR_API_KEY&username=VALUE"
response = requests.get(url)
print(response.json())js
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/instagram/get-user-detail/v1?token=YOUR_API_KEY&username=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/instagram/get-user-detail/v1?token=YOUR_API_KEY&username=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/instagram/get-user-detail/v1?token=YOUR_API_KEY&username=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/instagram/get-user-detail/v1?token=YOUR_API_KEY&username=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;Responses
json
{
"code": 0,
"data": {
"data": {
"about": {
"accounts_with_shared_followers": null,
"country": "Not shared",
"date_joined": "December 2017",
"date_joined_as_timestamp": 1512086400,
"date_verified": "March 2018",
"date_verified_as_timestamp": 1519862400,
"former_usernames": 0,
"id": 6648247795,
"is_verified": true,
"username": null
},
"account_badges": [],
"account_category": "",
"account_type": 3,
"active_standalone_fundraisers": {
"fundraisers": [],
"total_count": 0
},
"additional_business_addresses": [],
"adjusted_banners_order": [],
"ads_incentive_expiration_date": null,
"ads_page_id": null,
"ads_page_name": null,
"aigm_account_label_info": {
"is_auto_detected": false,
"is_enabled": false,
"is_manually_enabled": false
},
"allow_manage_memorialization": false,
"avatar_status": {
"has_avatar": false
},
"bio_links": [
{
"creation_source": "NONE",
"icon_url": "",
"image_url": "",
"is_pinned": false,
"is_verified": false,
"link_id": 17926844276532244,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=http%3A%2F%2Fweibo.com%2Fliuyifeiofficial%3Futm_source%3Dig%26utm_medium%3Dsocial%26utm_content%3Dlink_in_bio%26fbclid%3DPAZXh0bgNhZW0CMTEAc3J0YwZhcHBfaWQPNTY3MDY3MzQzMzUyNDI3AAGnKCY91YY0veBsh8zw7H1g4XpatUBWFh32mkMvrkRxM3nsUobEj7VIhM2Xnyg_aem_I21V2QpUQLxhrakJBkzsQg&e=AT4uUhtrSZE6hSdAQAolGav6G8MLlqksQY7J7WjmT_R2qs16ZAWd4cvpIdv6gKwf264NPKe-NSUGBHn68v12E-IHmZp6PjlTipMX9Ajc7w",
"media_accent_color_hex": "",
"media_type": "none",
"open_external_url_with_in_app_browser": true,
"title": "",
"url": "http://weibo.com/liuyifeiofficial"
}
],
"biography": "",
"biography_with_entities": {
"entities": [],
"raw_text": ""
},
"birthday_today_visibility_for_viewer": "NOT_VISIBLE",
"broadcast_chat_preference_status": {
"json_response": "{\"status\":\"ok\",\"status_code\":\"200\",\"is_broadcast_chat_creator\":true,\"notification_setting_type\":2}"
},
"business_contact_method": "UNKNOWN",
"can_add_fb_group_link_on_profile": false,
"can_hide_category": true,
"can_hide_public_contacts": true,
"can_send_direct_message": true,
"can_use_affiliate_partnership_messaging_as_brand": false,
"can_use_affiliate_partnership_messaging_as_creator": false,
"can_use_branded_content_discovery_as_brand": false,
"can_use_branded_content_discovery_as_creator": false,
"can_use_paid_partnership_messaging_as_creator": false,
"category": "",
"category_id": "0",
"chaining_upsell_cards": [],
"contact_phone_number": "",
"creator_shopping_info": {
"linked_merchant_accounts": []
},
"current_catalog_id": null,
"direct_messaging": "",
"disable_profile_shop_cta": false,
"eligible_for_text_app_activation_badge": false,
"enable_add_school_in_edit_profile": false,
"existing_user_age_collection_enabled": true,
"external_lynx_url": "https://l.instagram.com/?u=http%3A%2F%2Fweibo.com%2Fliuyifeiofficial%3Futm_source%3Dig%26utm_medium%3Dsocial%26utm_content%3Dlink_in_bio%26fbclid%3DPAZXh0bgNhZW0CMTEAc3J0YwZhcHBfaWQPNTY3MDY3MzQzMzUyNDI3AAGneuxZqf_z5MjSr1OFpXviAFL-VG9HtfdfTG2eRYDmZFXsmqYtkm4tJFr4cpA_aem_KYhcVLJbg6ot2ydkpXwOUQ&e=AT6Qlb09E2zX8AfU5B_Az4iMBhQaxFBQUpoPASoF9k3JEcz5vDRG6XeCjZbjUmjkdGON3K4fJIjdnYp5xBBDrUTp4ef03prnsgkQ1Je0NQ",
"external_url": "http://weibo.com/liuyifeiofficial",
"fan_club_info": {
"autosave_to_exclusive_highlight": null,
"connected_member_count": null,
"fan_club_id": null,
"fan_club_name": null,
"fan_consideration_page_revamp_eligiblity": null,
"has_created_ssc": null,
"has_enough_subscribers_for_ssc": null,
"is_fan_club_gifting_eligible": null,
"is_fan_club_referral_eligible": null,
"is_free_trial_eligible": null,
"largest_public_bc_id": null,
"should_show_playlists_in_profile_tab": null,
"subscriber_count": null
},
"fbid_v2": "17841406713871030",
"feed_post_reshare_disabled": false,
"follow_friction_type": 0,
"follower_count": 2520945,
"following_count": 49,
"full_name": "Liu Yifei",
"has_anonymous_profile_picture": false,
"has_collab_collections": false,
"has_ever_selected_topics": false,
"has_exclusive_feed_content": false,
"has_fan_club_subscriptions": false,
"has_gen_ai_personas_for_profile_banner": false,
"has_guides": false,
"has_highlight_reels": false,
"has_music_on_profile": false,
"has_nme_badge": false,
"has_private_collections": false,
"has_public_tab_threads": true,
"has_videos": true,
"has_views_fetching": true,
"has_visible_media_notes": false,
"hd_profile_pic_url_info": {
"height": 1080,
"url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/24177964_189054331645767_4251997617082335232_n.jpg?stp=dst-webp&cb=8438d1d6-9494a338&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QHRsLcBXKBMPUQPN2M8OV33GforH28Xyv6tJP9eMF4VwYjxUOTSQA4bN_nzUfqm0ck&_nc_ohc=bGSZDmSX6S4Q7kNvwGWUNRt&_nc_gid=9kMe1MBhRuovJZchwsAlVQ&edm=AO4kU9EBAAAA&ccb=7-5&ig_cache_key=GCztcAFH70ek8asAAAAAAABOIQI7bkULAAAB0w-ccb7-5-cb8438d1d6-9494a338&oh=00_AfySEeM3LXARkGwyFkzCuDa-gd-K8iUAyzklZU3AGY3NFA&oe=69B4C0CB&_nc_sid=164c1d",
"width": 1080
},
"hd_profile_pic_versions": [
{
"height": 320,
"url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/24177964_189054331645767_4251997617082335232_n.jpg?stp=dst-webp_s320x320&cb=8438d1d6-9494a338&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QHRsLcBXKBMPUQPN2M8OV33GforH28Xyv6tJP9eMF4VwYjxUOTSQA4bN_nzUfqm0ck&_nc_ohc=bGSZDmSX6S4Q7kNvwGWUNRt&_nc_gid=9kMe1MBhRuovJZchwsAlVQ&edm=AO4kU9EBAAAA&ccb=7-5&ig_cache_key=GCztcAFH70ek8asAAAAAAABOIQI7bkULAAAB3203200w-ccb7-5-cb8438d1d6-9494a338&oh=00_AfyIW2FlwF-i_zAArlRWMrZw9a41w9hZ3nLmZNMWUaXiSA&oe=69B4C0CB&_nc_sid=164c1d",
"width": 320
},
{
"height": 640,
"url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/24177964_189054331645767_4251997617082335232_n.jpg?stp=dst-webp_s640x640&cb=8438d1d6-9494a338&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QHRsLcBXKBMPUQPN2M8OV33GforH28Xyv6tJP9eMF4VwYjxUOTSQA4bN_nzUfqm0ck&_nc_ohc=bGSZDmSX6S4Q7kNvwGWUNRt&_nc_gid=9kMe1MBhRuovJZchwsAlVQ&edm=AO4kU9EBAAAA&ccb=7-5&ig_cache_key=GCztcAFH70ek8asAAAAAAABOIQI7bkULAAAB6406400w-ccb7-5-cb8438d1d6-9494a338&oh=00_AfwIyoBDEJX3t1qlK50dnyVAcAqzBMtX5RKxhJZ8Mjc36g&oe=69B4C0CB&_nc_sid=164c1d",
"width": 640
}
],
"highlight_reshare_disabled": false,
"highlights_tray_type": "DEFAULT",
"id": "6648247795",
"include_direct_blacklist_status": true,
"instagram_pk": "6648247795",
"interop_messaging_user_fbid": 118764732848944,
"is_active_on_text_post_app": false,
"is_auto_confirm_enabled_for_all_reciprocal_follow_requests": false,
"is_bestie": false,
"is_business": false,
"is_call_to_action_enabled": false,
"is_cannes": false,
"is_category_tappable": false,
"is_coppa_enforced": false,
"is_creator_agent_enabled": false,
"is_creator_marketplace_badge_visible": false,
"is_daily_limit_blocking": false,
"is_direct_roll_call_enabled": true,
"is_eligible_for_creator_product_links": false,
"is_eligible_for_diverse_owned_business_info": false,
"is_eligible_for_meta_verified_enhanced_link_sheet": false,
"is_eligible_for_meta_verified_enhanced_link_sheet_consumption": false,
"is_eligible_for_meta_verified_ig_self_profile_not_verified_badge": false,
"is_eligible_for_meta_verified_label": true,
"is_eligible_for_meta_verified_links_in_post": false,
"is_eligible_for_meta_verified_links_in_reels": false,
"is_eligible_for_meta_verified_multiple_addresses_consumption": false,
"is_eligible_for_meta_verified_multiple_addresses_creation": false,
"is_eligible_for_meta_verified_related_accounts": false,
"is_eligible_for_post_boost_mv_upsell": false,
"is_eligible_for_schools_search_upsell": false,
"is_eligible_for_slide": false,
"is_eligible_to_display_diverse_owned_business_info": false,
"is_facebook_onboarded_charity": false,
"is_favorite": false,
"is_favorite_for_clips": false,
"is_favorite_for_highlights": false,
"is_favorite_for_stories": false,
"is_guardian_r_account_cannes_pair": false,
"is_in_canada": false,
"is_interest_account": true,
"is_memorialized": false,
"is_meta_verified_related_accounts_display_enabled": false,
"is_new_to_instagram": false,
"is_onboarding_account": false,
"is_opal_enabled": false,
"is_open_to_collab": false,
"is_oregon_custom_gender_consented": false,
"is_parenting_account": false,
"is_potential_business": false,
"is_prime_onboarding_account": false,
"is_private": false,
"is_profile_audio_call_enabled": false,
"is_profile_broadcast_sharing_enabled": true,
"is_profile_picture_expansion_enabled": true,
"is_profile_search_enabled": false,
"is_profile_wa_calling_enabled": false,
"is_recon_ad_cta_on_profile_eligible_with_viewer": true,
"is_regulated_c18": false,
"is_regulated_news_in_viewer_location": false,
"is_remix_setting_enabled_for_posts": false,
"is_remix_setting_enabled_for_reels": false,
"is_ring_creator": false,
"is_secondary_account_creation": false,
"is_stories_teaser_muted": false,
"is_supervision_features_enabled": false,
"is_verified": true,
"is_whatsapp_linked": false,
"latest_besties_reel_media": 0,
"latest_reel_media": 0,
"live_subscription_status": "default",
"location_data": {
"address_street": "",
"city_id": "0",
"city_name": "",
"instagram_location_id": "",
"latitude": 0,
"longitude": 0,
"zip": ""
},
"media_count": 272,
"merchant_checkout_style": "none",
"meta_verified_benefits_info": {
"active_meta_verified_benefits": [],
"is_eligible_for_ig_meta_verified_label": false,
"is_eligible_for_meta_verified_content_protection": false
},
"meta_verified_related_accounts_count": 0,
"nametag": {
"available_theme_colors": [
-1,
7747834,
13828293,
16712041,
16742912,
0
],
"background_image_url": "",
"emoji": "😀",
"emoji_color": 0,
"gradient": 2,
"is_background_image_blurred": false,
"mode": 0,
"selected_theme_color": -1,
"selfie_sticker": 0,
"selfie_url": "",
"theme_color": {
"available_theme_colors": [
{
"display_label": "Default",
"int_value": -1
},
{
"display_label": "Purple",
"int_value": 7747834
},
{
"display_label": "Lavender",
"int_value": 13828293
},
{
"display_label": "Pink",
"int_value": 16712041
},
{
"display_label": "Orange",
"int_value": 16742912
},
{
"display_label": "Black",
"int_value": 0
}
],
"selected_theme_color": {
"display_label": "Default",
"int_value": -1
}
}
},
"nonpro_can_maybe_see_profile_hypercard": false,
"not_meta_verified_friction_info": {
"is_eligible_for_label_friction": false,
"label_friction_content": "Not Meta Verified"
},
"open_external_url_with_in_app_browser": true,
"page_id": null,
"page_name": null,
"pinned_channels_info": {
"has_public_channels": false,
"pinned_channels_list": []
},
"posts_subscription_status": "default",
"primary_profile_link_type": 0,
"professional_conversion_suggested_account_type": 3,
"profile_context": "",
"profile_context_facepile_users": [],
"profile_context_links_with_user_ids": [],
"profile_overlay_info": {
"bloks_payload": null,
"overlay_format": "NONE"
},
"profile_pic_genai_tool_info": [],
"profile_pic_id": "1660311735996807053",
"profile_pic_url": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/24177964_189054331645767_4251997617082335232_n.jpg?stp=dst-webp_s150x150&cb=8438d1d6-9494a338&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QGxs6qjFnpw5tfUtHza5VS1XtzzyTPKyQYPovj8_MIFogYM4lC6wTEm-A3W07I2lQE&_nc_ohc=bGSZDmSX6S4Q7kNvwGWUNRt&_nc_gid=9kMe1MBhRuovJZchwsAlVQ&edm=AO4kU9EBAAAA&ccb=7-5&ig_cache_key=GCztcAFH70ek8asAAAAAAABOIQI7bkULAAAB1501500w-ccb7-5-cb8438d1d6-9494a338&oh=00_AfypAdSHfuJjzt1EAOT0uEBXfulpgWlP91anrHu0Oq4pew&oe=69B4C0CB&_nc_sid=164c1d",
"profile_pic_url_hd": "https://scontent-sea5-1.cdninstagram.com/v/t51.2885-19/24177964_189054331645767_4251997617082335232_n.jpg?stp=dst-webp_s640x640&cb=8438d1d6-9494a338&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sea5-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QHRsLcBXKBMPUQPN2M8OV33GforH28Xyv6tJP9eMF4VwYjxUOTSQA4bN_nzUfqm0ck&_nc_ohc=bGSZDmSX6S4Q7kNvwGWUNRt&_nc_gid=9kMe1MBhRuovJZchwsAlVQ&edm=AO4kU9EBAAAA&ccb=7-5&ig_cache_key=GCztcAFH70ek8asAAAAAAABOIQI7bkULAAAB6406400w-ccb7-5-cb8438d1d6-9494a338&oh=00_AfwIyoBDEJX3t1qlK50dnyVAcAqzBMtX5RKxhJZ8Mjc36g&oe=69B4C0CB&_nc_sid=164c1d",
"profile_reels_sorting_eligibility": "CHECK_VIEWER_QE",
"profile_type": 0,
"pronouns": [],
"public_email": "",
"public_phone_country_code": "",
"public_phone_number": "",
"qa_freeform_banner_available_prompts": [],
"recon_features": {
"enable_recon_cta": true
},
"recs_from_friends": {
"enable_recs_from_friends": false,
"recs_from_friends_entry_point_type": "banner"
},
"reels_subscription_status": "default",
"relevant_news_regulation_locations": [],
"remove_message_entrypoint": false,
"request_contact_enabled": false,
"ring_creator_metadata": [],
"seller_shoppable_feed_type": "none",
"should_show_tagged_tab": true,
"show_account_transparency_details": true,
"show_all_highlights_as_selected_in_management_screen": false,
"show_blue_badge_on_main_profile": true,
"show_post_insights_entry_point": true,
"show_ring_award": false,
"show_schools_badge": null,
"show_shoppable_feed": false,
"show_wa_link_on_profile": false,
"spam_follower_setting_enabled": true,
"stories_subscription_status": "default",
"text_app_last_visited_time": null,
"third_party_downloads_enabled": 2,
"threads_profile_glyph_url": "barcelona://user?username=yifei_cc&xmt=AQF0-NG6XiVSh3Ec0R9wG3_9m_MQ985za9TwzgOByXkfqO4",
"total_ar_effects": 0,
"transparency_product_enabled": false,
"trial_clips_enabled": false,
"trial_clips_rate_limiting": {
"at_limit_body": "You've shared the maximum number of trial reels allowed within 24 hours. You can share this reel to everyone now as a regular reel or wait up to 24 hours to share it as a trial reel.",
"at_limit_title": "You've reached the limit",
"count": 20,
"warning_body": "You've almost reached the limit. Once you share this trial reel, you'll need to wait up to 24 hours to start using trial reels again.",
"warning_title": "You can share one more trial reel"
},
"upcoming_events": [],
"username": "yifei_cc",
"views_on_grid_status": "SHOW_VIEWS_ON_GRID",
"wa_calling_option_for_legacy_num": 0,
"wa_calling_option_for_wa_linked": 0,
"whatsapp_number": ""
}
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.