Basic Profile
curl --request GET \
--url https://api.sociavault.com/v1/scrape/instagram/basic-profile \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/instagram/basic-profile"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/instagram/basic-profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/instagram/basic-profile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/instagram/basic-profile"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/instagram/basic-profile")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/instagram/basic-profile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"pk": "270598518",
"friendship_status": null,
"gating": null,
"fbid_v2": "17841400195544228",
"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": {
"0": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Ftrip-to-the-brite-side-collection&e=AUBCwM-UtnGEDDLVRqVt8UuGuVYMHnGaDtVVQCj-od5nNSwHE2sL6Gg7tAcQxJfMbCKRjwsODgZZs2BjhNVc3yXY8mLOowmkjA1sjoxH6oG-LL1lrzKbu_zxECRBHXOpFrKykrf0-QDPcxxZabghuu7spNY",
"media_accent_color_hex": "",
"media_type": "none",
"title": "Shop Vacation Ready Brights!",
"url": "https://www.opi.com/collections/trip-to-the-brite-side-collection",
"creation_source": "NONE"
},
"1": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Fchrome&e=AUBkY8JAcllQ0W8WNGq_RTPZenZSPDME1MLui7GaChhAaDGJHMOui0k0ZfGJi7bMU84_53rrGCuD2GRdD8m8foXHSsc2hW9TqU1VZG1hmdKee0NH7nlceq2AMseo3mIb3RozCS9QHjR82Tm9lgI0mFZ-euA",
"media_accent_color_hex": "",
"media_type": "none",
"title": "Shop Chrome Powders ✨",
"url": "https://www.opi.com/collections/chrome",
"creation_source": "NONE"
},
"2": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Finfinite-shine&e=AUA8vNpZhb8kTogxtpCZum4N8ysnPNw5xcc2USZ4dy7HNVHYrF8hzUdeA2ys5hhdjesn-38kj1kmcQuSYk2S1n6qI8wNaih0I5L8SOm95qBvIA4PXQ-k7IEr8EFx8pLvSu7hf60rCuZsEFsl1Mvw9quw_X8",
"media_accent_color_hex": "",
"media_type": "none",
"title": "Shop Infinite Shine Glaze Toppers ✨",
"url": "https://www.opi.com/collections/infinite-shine",
"creation_source": "NONE"
},
"3": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Fthe-new-opicons-collection&e=AUBPJB-yeUHDifjTahe_NJqe9i8k5jDkMPY4DvMTfagSjRCy67BFV9c1DAYw8UtRqfGtDHINcCxLnpfHt7uNu7HzlBdZu1A8pNeiOIHDpjMGLct_BwIHhSg4uGpb3rw2ZHHMOpha2AGg4gsGf1nrbeDXn38",
"media_accent_color_hex": "",
"media_type": "none",
"title": "The New OPIcons! Spring Collection",
"url": "https://www.opi.com/collections/the-new-opicons-collection",
"creation_source": "NONE"
},
"4": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fyoutube.com%2Fplaylist%3Flist%3DPLQJUg0LNqNatz073eArBzAYkyokvs7mtW%26si%3DRx2D8aUOkVqCM0Rn&e=AUDUWoxhAyC9ecE3IanhRoJlVqAkbCjNfgP06Go6jeUrroM5eq3xuF0Xmyod4_Cb4_xIuBdzSSYNGWwXwn97OJYAF02UbF4RR_P364063a9oZwF7T6B-AXJlhpUUHHJzaJvG9kgFflnpfnPVR80cOZrpasw",
"media_accent_color_hex": "",
"media_type": "none",
"title": "GELiversity™: Gel Manis 101",
"url": "https://youtube.com/playlist?list=PLQJUg0LNqNatz073eArBzAYkyokvs7mtW&si=Rx2D8aUOkVqCM0Rn",
"creation_source": "NONE"
}
},
"linked_fb_info": null,
"text_post_app_badge_label": "opi",
"show_text_post_app_badge": true,
"username": "opi",
"live_broadcast_visibility": null,
"live_broadcast_id": null,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.2885-19/332508693_716166386813792_8306749939985552435_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=103&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=l54plO_snEUQ7kNvwH2GL7u&_nc_oc=AdrK2tqWsjKtiKPx9jjJ_irkTObX70eXbAQR7ILICWQAJM63B7a8HLDqoZmztPUA4aM&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7fa8c&oh=00_AQCGiWXJOiPe5Bzqw53CsPfHNy0tbr_Dca1H7M2Gb-BpiQ&oe=6A629E04",
"hd_profile_pic_url_info": {
"url": "https://scontent.cdninstagram.com/v/t51.2885-19/332508693_716166386813792_8306749939985552435_n.jpg?_nc_cat=103&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=l54plO_snEUQ7kNvwH2GL7u&_nc_oc=AdrK2tqWsjKtiKPx9jjJ_irkTObX70eXbAQR7ILICWQAJM63B7a8HLDqoZmztPUA4aM&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7fa8c&oh=00_AQD2iMpq37UKxliY8C5oiPjt8xHC3aD55R3QeRXgB_D7gg&oe=6A629E04"
},
"is_unpublished": false,
"latest_reel_media": null,
"has_profile_pic": null,
"profile_pic_genai_tool_info": {},
"biography": "Now showing: Fierce shades and press-ons inspired by SUPERGIRL, the movie.\nSee @SUPERGIRL, only in theaters June 26. #Supergirl",
"full_name": "OPI",
"is_verified": true,
"show_account_transparency_details": true,
"account_type": 2,
"follower_count": 2058273,
"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": {
"0": {
"hashtag": {
"name": "supergirl",
"id": "17841596728075706"
},
"user": null
},
"1": {
"hashtag": null,
"user": {
"username": "supergirl",
"id": "74857251343"
}
}
}
},
"category": "",
"should_show_category": true,
"aigm_account_label_info": null,
"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=https%3A%2F%2Fwww.opi.com%2Fcollections%2Ftrip-to-the-brite-side-collection&e=AUB04SfhiUARJpDFtagn4s49s2-7O6tk3x_4N6ldJ997oq8QlCWMcwyMBVOXg4UkdlbJml9krZWOWcf0I587bD2Z7oDNJEXx3E8mvJ1HiaqhhhUtE1Jevl0kdsFXsRAGTM8B7aahMUCC47L_F0GVX5qprko",
"external_url": "https://www.opi.com/collections/trip-to-the-brite-side-collection",
"pronouns": {},
"transparency_label": null,
"transparency_product": null,
"hide_creator_marketplace_badge": false,
"id": "270598518",
"has_chaining": null,
"remove_message_entrypoint": null,
"is_embeds_disabled": false,
"is_cannes": false,
"is_professional_account": null,
"following_count": 1455,
"media_count": null,
"total_clips_count": 1,
"latest_besties_reel_media": null,
"reel_media_seen_timestamp": null
},
"credits_used": 1,
"endpoint": "instagram/basic_profile"
}{
"error": "Missing required parameter: handle",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}Instagram
Basic Profile
Get a basic public Instagram profile by numeric user ID. Useful as a fallback when a handle-based lookup fails (some valid accounts return “account does not exist” when queried by username).
GET
/
v1
/
scrape
/
instagram
/
basic-profile
Basic Profile
curl --request GET \
--url https://api.sociavault.com/v1/scrape/instagram/basic-profile \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/instagram/basic-profile"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/instagram/basic-profile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/instagram/basic-profile",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/instagram/basic-profile"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/instagram/basic-profile")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/instagram/basic-profile")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"success": true,
"pk": "270598518",
"friendship_status": null,
"gating": null,
"fbid_v2": "17841400195544228",
"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": {
"0": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Ftrip-to-the-brite-side-collection&e=AUBCwM-UtnGEDDLVRqVt8UuGuVYMHnGaDtVVQCj-od5nNSwHE2sL6Gg7tAcQxJfMbCKRjwsODgZZs2BjhNVc3yXY8mLOowmkjA1sjoxH6oG-LL1lrzKbu_zxECRBHXOpFrKykrf0-QDPcxxZabghuu7spNY",
"media_accent_color_hex": "",
"media_type": "none",
"title": "Shop Vacation Ready Brights!",
"url": "https://www.opi.com/collections/trip-to-the-brite-side-collection",
"creation_source": "NONE"
},
"1": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Fchrome&e=AUBkY8JAcllQ0W8WNGq_RTPZenZSPDME1MLui7GaChhAaDGJHMOui0k0ZfGJi7bMU84_53rrGCuD2GRdD8m8foXHSsc2hW9TqU1VZG1hmdKee0NH7nlceq2AMseo3mIb3RozCS9QHjR82Tm9lgI0mFZ-euA",
"media_accent_color_hex": "",
"media_type": "none",
"title": "Shop Chrome Powders ✨",
"url": "https://www.opi.com/collections/chrome",
"creation_source": "NONE"
},
"2": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Finfinite-shine&e=AUA8vNpZhb8kTogxtpCZum4N8ysnPNw5xcc2USZ4dy7HNVHYrF8hzUdeA2ys5hhdjesn-38kj1kmcQuSYk2S1n6qI8wNaih0I5L8SOm95qBvIA4PXQ-k7IEr8EFx8pLvSu7hf60rCuZsEFsl1Mvw9quw_X8",
"media_accent_color_hex": "",
"media_type": "none",
"title": "Shop Infinite Shine Glaze Toppers ✨",
"url": "https://www.opi.com/collections/infinite-shine",
"creation_source": "NONE"
},
"3": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fwww.opi.com%2Fcollections%2Fthe-new-opicons-collection&e=AUBPJB-yeUHDifjTahe_NJqe9i8k5jDkMPY4DvMTfagSjRCy67BFV9c1DAYw8UtRqfGtDHINcCxLnpfHt7uNu7HzlBdZu1A8pNeiOIHDpjMGLct_BwIHhSg4uGpb3rw2ZHHMOpha2AGg4gsGf1nrbeDXn38",
"media_accent_color_hex": "",
"media_type": "none",
"title": "The New OPIcons! Spring Collection",
"url": "https://www.opi.com/collections/the-new-opicons-collection",
"creation_source": "NONE"
},
"4": {
"image_url": "",
"is_pinned": false,
"link_type": "external",
"lynx_url": "https://l.instagram.com/?u=https%3A%2F%2Fyoutube.com%2Fplaylist%3Flist%3DPLQJUg0LNqNatz073eArBzAYkyokvs7mtW%26si%3DRx2D8aUOkVqCM0Rn&e=AUDUWoxhAyC9ecE3IanhRoJlVqAkbCjNfgP06Go6jeUrroM5eq3xuF0Xmyod4_Cb4_xIuBdzSSYNGWwXwn97OJYAF02UbF4RR_P364063a9oZwF7T6B-AXJlhpUUHHJzaJvG9kgFflnpfnPVR80cOZrpasw",
"media_accent_color_hex": "",
"media_type": "none",
"title": "GELiversity™: Gel Manis 101",
"url": "https://youtube.com/playlist?list=PLQJUg0LNqNatz073eArBzAYkyokvs7mtW&si=Rx2D8aUOkVqCM0Rn",
"creation_source": "NONE"
}
},
"linked_fb_info": null,
"text_post_app_badge_label": "opi",
"show_text_post_app_badge": true,
"username": "opi",
"live_broadcast_visibility": null,
"live_broadcast_id": null,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.2885-19/332508693_716166386813792_8306749939985552435_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=103&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=l54plO_snEUQ7kNvwH2GL7u&_nc_oc=AdrK2tqWsjKtiKPx9jjJ_irkTObX70eXbAQR7ILICWQAJM63B7a8HLDqoZmztPUA4aM&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7fa8c&oh=00_AQCGiWXJOiPe5Bzqw53CsPfHNy0tbr_Dca1H7M2Gb-BpiQ&oe=6A629E04",
"hd_profile_pic_url_info": {
"url": "https://scontent.cdninstagram.com/v/t51.2885-19/332508693_716166386813792_8306749939985552435_n.jpg?_nc_cat=103&ccb=7-5&_nc_sid=bf7eb4&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=l54plO_snEUQ7kNvwH2GL7u&_nc_oc=AdrK2tqWsjKtiKPx9jjJ_irkTObX70eXbAQR7ILICWQAJM63B7a8HLDqoZmztPUA4aM&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7fa8c&oh=00_AQD2iMpq37UKxliY8C5oiPjt8xHC3aD55R3QeRXgB_D7gg&oe=6A629E04"
},
"is_unpublished": false,
"latest_reel_media": null,
"has_profile_pic": null,
"profile_pic_genai_tool_info": {},
"biography": "Now showing: Fierce shades and press-ons inspired by SUPERGIRL, the movie.\nSee @SUPERGIRL, only in theaters June 26. #Supergirl",
"full_name": "OPI",
"is_verified": true,
"show_account_transparency_details": true,
"account_type": 2,
"follower_count": 2058273,
"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": {
"0": {
"hashtag": {
"name": "supergirl",
"id": "17841596728075706"
},
"user": null
},
"1": {
"hashtag": null,
"user": {
"username": "supergirl",
"id": "74857251343"
}
}
}
},
"category": "",
"should_show_category": true,
"aigm_account_label_info": null,
"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=https%3A%2F%2Fwww.opi.com%2Fcollections%2Ftrip-to-the-brite-side-collection&e=AUB04SfhiUARJpDFtagn4s49s2-7O6tk3x_4N6ldJ997oq8QlCWMcwyMBVOXg4UkdlbJml9krZWOWcf0I587bD2Z7oDNJEXx3E8mvJ1HiaqhhhUtE1Jevl0kdsFXsRAGTM8B7aahMUCC47L_F0GVX5qprko",
"external_url": "https://www.opi.com/collections/trip-to-the-brite-side-collection",
"pronouns": {},
"transparency_label": null,
"transparency_product": null,
"hide_creator_marketplace_badge": false,
"id": "270598518",
"has_chaining": null,
"remove_message_entrypoint": null,
"is_embeds_disabled": false,
"is_cannes": false,
"is_professional_account": null,
"following_count": 1455,
"media_count": null,
"total_clips_count": 1,
"latest_besties_reel_media": null,
"reel_media_seen_timestamp": null
},
"credits_used": 1,
"endpoint": "instagram/basic_profile"
}{
"error": "Missing required parameter: handle",
"endpoint": "<string>",
"credits_required": 123
}{
"error": "Invalid API key",
"docs": "https://docs.sociavault.com/authentication"
}{
"error": "Insufficient credits",
"required": 1,
"available": 0
}{
"error": "Service configuration error"
}💳 1 credit per request
Authorizations
Query Parameters
Instagram numeric user ID
Example:
"314216"
Response
Successful response
Key Response Fields:
data.pk/data.id: Numeric Instagram user IDdata.username: Instagram handledata.full_name: Display namedata.biography: Bio textdata.bio_links[].url: Bio link URLsdata.external_url: Primary link in biodata.follower_count: Followers countdata.following_count: Following countdata.media_count: Total post countdata.is_verified: Whether the account is verifieddata.is_private: Whether the account is privatedata.is_business: Whether it's a business accountdata.is_professional_account: Whether it's a professional/creator accountdata.account_type: Account typedata.category: Business/creator category (when available)data.city_name: Business city (when available)data.profile_pic_url: Profile picture URL (low-res)data.hd_profile_pic_url_info.url: Profile picture URL (high-res)
⌘I