> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # 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). 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/instagram/basic-profile openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/instagram/basic-profile: get: tags: - instagram summary: Basic Profile description: >- 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). operationId: instagram_BasicProfile parameters: - name: userId in: query description: Instagram numeric user ID required: true schema: type: string example: '314216' responses: '200': description: >- Successful response **Key Response Fields:** - `data.pk` / `data.id`: Numeric Instagram user ID - `data.username`: Instagram handle - `data.full_name`: Display name - `data.biography`: Bio text - `data.bio_links[].url`: Bio link URLs - `data.external_url`: Primary link in bio - `data.follower_count`: Followers count - `data.following_count`: Following count - `data.media_count`: Total post count - `data.is_verified`: Whether the account is verified - `data.is_private`: Whether the account is private - `data.is_business`: Whether it's a business account - `data.is_professional_account`: Whether it's a professional/creator account - `data.account_type`: Account type - `data.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) content: application/json: example: 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. See @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 '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````