> ## Documentation Index > Fetch the complete documentation index at: https://docs.influship.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Live Instagram Profile > Retrieve Instagram profile details, follower counts, bio, and recent activity. **Use this endpoint to:** - Research a known Instagram account - Retrieve profile metrics and recent posts - Review a profile before a campaign For creator summaries and campaign research, use [profile lookup](/api-reference/profiles/get-profile-by-platform-and-username). See [data freshness](/guides/data-freshness) to choose the data you need. If a complete requested profile cannot be recovered within the request deadline, this endpoint returns `503` with `service_unavailable`. Preserve any cached profile and retry with bounded backoff; an unavailable source response is not evidence of an empty or inactive profile. The profile response returns an empty `posts[]` array unless `include_posts=true`. When posts are included, `post_limit` accepts 1-50 and defaults to 12. The array contains the recent posts available in Instagram's source response, up to that limit. Video posts include a fresh `video_url`. A profile request costs 0.5 credits ($0.005), compared with 1 credit for each individual post lookup. **Availability:** When live data is temporarily unavailable this endpoint returns `503` with `error.code: service_unavailable` in the standard error envelope. Honor `Retry-After` when present and retry with bounded backoff; you are not charged for `503` responses. **Pricing**: 0.5 credits per profile scraped ($0.005) ## OpenAPI ````yaml /openapi/openapi.documented.yml get /v1/raw/instagram/profile/{username} openapi: 3.1.0 info: title: Influship API version: 1.0.0 description: > Public API for creator search, profile lookup, and campaign-fit analysis. ## Authentication Send your API key in the `X-API-Key` header on every authenticated request. ```bash curl -H "X-API-Key: your_api_key" https://api.influship.com/v1/creators/autocomplete?q=fitness ``` ## Billing and Rate Limits The API uses credit-based billing and credit-based rate limits. - every endpoint has a credit cost - successful responses include `X-Credits-Charged` and `X-Credits-Features` - rate limits are enforced with per-minute and per-hour credit budgets - rate limit state is returned in the `RateLimit-*` headers ## Agentic Payments Use `https://api.influship.com/openapi.json` to discover endpoints that accept x402 v2 or MPP payments without an API key. It includes `402` payment challenges and `x-payment-info` metadata for the available payment methods. ## Pagination List endpoints use cursor pagination. - send `limit` to control page size - use `next_cursor` from the response to fetch the next page - stop when `has_more` is `false` Search has one special rule: - `POST /v1/search` creates a persisted search session - `GET /v1/search/{id}` paginates that session for free - free pagination is capped by the original search `limit` ## Errors Errors use a consistent shape: ```json { "error": { "code": "rate_limit_exceeded", "message": "Rate limit exceeded (per minute)" } } ``` See each operation for exact request and response schemas. contact: name: Influship Support email: support@influship.com license: name: Proprietary url: https://influship.com/terms servers: - url: https://api.influship.com description: Production security: - ApiKeyAuth: [] tags: - name: Shortlists description: Private creator shortlists saved to your API account or OAuth user. - name: Health description: API health and status endpoints - name: Creators description: >- Retrieve creator profiles and discover new creators through search, autocomplete, and lookalike matching. Creators are cross-platform entities that may have profiles on multiple social networks. - name: Profiles description: >- Access individual social media profiles with detailed metrics, growth data, and activity information. Profiles are platform-specific accounts linked to creators. - name: Creator Emails description: >- Look up known creator email addresses by creator ID or social username. Empty or unresolved results are not billable. - name: Posts description: >- Retrieve and analyze social media posts with engagement metrics, media content, and performance data. - name: Search description: >- AI-powered semantic search to find creators using natural language queries. Understands intent and context to match creators based on content themes, audience, and style. - name: Live Scraping description: >- Research Instagram, TikTok, and YouTube profiles, content, metrics, and transcripts with live platform endpoints. paths: /v1/raw/instagram/profile/{username}: get: tags: - Live Scraping summary: Get Live Instagram Profile description: >- Retrieve Instagram profile details, follower counts, bio, and recent activity. **Use this endpoint to:** - Research a known Instagram account - Retrieve profile metrics and recent posts - Review a profile before a campaign For creator summaries and campaign research, use [profile lookup](/api-reference/profiles/get-profile-by-platform-and-username). See [data freshness](/guides/data-freshness) to choose the data you need. If a complete requested profile cannot be recovered within the request deadline, this endpoint returns `503` with `service_unavailable`. Preserve any cached profile and retry with bounded backoff; an unavailable source response is not evidence of an empty or inactive profile. The profile response returns an empty `posts[]` array unless `include_posts=true`. When posts are included, `post_limit` accepts 1-50 and defaults to 12. The array contains the recent posts available in Instagram's source response, up to that limit. Video posts include a fresh `video_url`. A profile request costs 0.5 credits ($0.005), compared with 1 credit for each individual post lookup. **Availability:** When live data is temporarily unavailable this endpoint returns `503` with `error.code: service_unavailable` in the standard error envelope. Honor `Retry-After` when present and retry with bounded backoff; you are not charged for `503` responses. **Pricing**: 0.5 credits per profile scraped ($0.005) operationId: getLiveInstagramProfile parameters: - schema: description: Include recent posts in response example: true type: boolean in: query name: include_posts description: Include recent posts in response - schema: default: 12 description: Number of posts to include example: 12 type: integer minimum: 1 maximum: 50 in: query name: post_limit description: Number of posts to include - schema: type: string minLength: 1 maxLength: 50 description: Username on the platform example: fitness_coach_jane in: path name: username required: true description: Username on the platform responses: '200': description: Successful response content: application/json: schema: $ref: '#/components/schemas/LiveProfileResponse' '400': description: Validation error response content: application/json: schema: $ref: '#/components/schemas/Error400' '401': description: Authentication error response content: application/json: schema: $ref: '#/components/schemas/Error401' '402': description: >- Account billing requires attention, or available credits cannot cover this request. content: application/json: schema: $ref: '#/components/schemas/ApiCreditError402' '403': description: Permission error response content: application/json: schema: $ref: '#/components/schemas/Error403' '404': description: Not found error response content: application/json: schema: $ref: '#/components/schemas/Error404' '429': description: >- Rate limit exceeded response. Check Retry-After header for backoff timing. Also returned (without RateLimit-* headers) when an IP is temporarily blocked after repeated failed authentication attempts. content: application/json: schema: $ref: '#/components/schemas/Error429' '500': description: Internal server error response content: application/json: schema: $ref: '#/components/schemas/Error500' '502': description: >- The upstream source answered, but with data this endpoint cannot process — for example a response schema the source has retired. Unlike 503 this is deterministic: the same request will keep failing until a fix ships, so it never carries Retry-After and retrying only burns credits. These are alerted on automatically. content: application/json: schema: $ref: '#/components/schemas/Error502' '503': description: >- Service temporarily unavailable. Check Retry-After when present and retry with bounded backoff. content: application/json: schema: $ref: '#/components/schemas/Error503' x-codeSamples: - lang: JavaScript source: >- import Influship from 'influship'; const client = new Influship({ apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted }); const response = await client.raw.instagram.getProfile('fitness_coach_jane'); console.log(response.data); components: schemas: LiveProfileResponse: type: object properties: data: type: object properties: username: type: string user_id: type: string full_name: type: string biography: type: string follower_count: type: number following_count: type: number media_count: type: - number - 'null' description: >- Total profile media count, or null when unavailable. Zero means an observed empty profile; this is not the number of posts returned. is_verified: type: boolean is_private: type: boolean profile_pic_url: type: string format: uri profile_pic_url_hd: type: string format: uri external_url: type: - string - 'null' format: uri bio_links: type: array items: type: object properties: title: type: string url: type: string format: uri link_type: type: string required: - title - url additionalProperties: false pronouns: type: array items: type: string category_name: type: - string - 'null' engagement_rate: type: number posts: type: array items: type: object properties: id: type: string shortcode: type: string owner_username: type: string display_url: type: string format: uri is_video: type: boolean post_type: type: string enum: - image - video - carousel like_count: type: number comment_count: type: number caption: type: - string - 'null' taken_at: type: - number - 'null' accessibility_caption: type: - string - 'null' video_url: type: string format: uri thumbnail_url: type: string format: uri view_count: type: number carousel_items: type: array items: type: object properties: index: type: number display_url: type: string format: uri is_video: type: boolean video_url: type: string format: uri thumbnail_url: type: string format: uri required: - index - display_url - is_video additionalProperties: false coauthor_usernames: type: array items: type: string is_paid_partnership: type: - boolean - 'null' sponsor_usernames: type: array items: type: string tagged_usernames: type: array items: type: string product_mentions: type: array items: type: object properties: product_id: type: - string - 'null' product_name: type: - string - 'null' merchant_username: type: - string - 'null' additionalProperties: false display_resources: type: array items: type: object properties: src: type: string format: uri config_width: type: number config_height: type: number required: - src - config_width - config_height additionalProperties: false video_versions: type: array items: type: object properties: id: type: string type: type: number url: type: string format: uri width: type: number height: type: number required: - url additionalProperties: false music_attribution: type: - object - 'null' properties: artist_name: type: - string - 'null' song_name: type: - string - 'null' audio_id: type: - string - 'null' uses_original_audio: type: - boolean - 'null' should_mute_audio: type: - boolean - 'null' additionalProperties: false location: type: - object - 'null' properties: id: type: - string - 'null' name: type: - string - 'null' slug: type: - string - 'null' has_public_page: type: - boolean - 'null' lat: type: - number - 'null' lng: type: - number - 'null' address_json: type: - object - 'null' properties: {} additionalProperties: x-stainless-any: true additionalProperties: false is_pinned: type: - boolean - 'null' engagement_visibility: type: - object - 'null' properties: viewer_can_reshare: type: - boolean - 'null' comments_disabled: type: - boolean - 'null' like_and_view_counts_disabled: type: - boolean - 'null' additionalProperties: false required: - id - shortcode - display_url - is_video - post_type - like_count - comment_count - caption - taken_at additionalProperties: false related_profiles: type: array items: type: object properties: username: type: string full_name: type: - string - 'null' profile_pic_url: type: - string - 'null' format: uri is_verified: type: boolean is_private: type: boolean required: - username - full_name - profile_pic_url - is_verified - is_private additionalProperties: false scraped_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - username - user_id - full_name - biography - follower_count - following_count - media_count - is_verified - is_private - profile_pic_url - external_url - bio_links - pronouns - category_name - engagement_rate - posts - related_profiles - scraped_at additionalProperties: false required: - data additionalProperties: false Error400: $ref: '#/components/schemas/Error' description: Validation error response examples: - error: code: validation_error message: 'Invalid value for parameter ''limit'': must be between 1 and 100' param: limit request_id: 550e8400-e29b-41d4-a716-446655440000 Error401: $ref: '#/components/schemas/Error' description: Authentication error response examples: - error: code: unauthorized message: API key missing or invalid request_id: 550e8400-e29b-41d4-a716-446655440000 ApiCreditError402: anyOf: - $ref: '#/components/schemas/Error402' - $ref: '#/components/schemas/ErrorInsufficientCredits' description: >- Account billing requires attention, or available credits cannot cover this request. Error403: $ref: '#/components/schemas/Error' description: Permission error response examples: - error: code: forbidden message: Your plan does not include access to this endpoint request_id: 550e8400-e29b-41d4-a716-446655440000 Error404: $ref: '#/components/schemas/Error' description: Not found error response examples: - error: code: not_found message: Creator with ID '123e4567-e89b-12d3-a456-426614174000' not found request_id: 550e8400-e29b-41d4-a716-446655440000 Error429: $ref: '#/components/schemas/Error' description: >- Rate limit exceeded response. Check Retry-After header for backoff timing. Also returned (without RateLimit-* headers) when an IP is temporarily blocked after repeated failed authentication attempts. examples: - error: code: rate_limit_exceeded message: Rate limit exceeded (per minute) request_id: 550e8400-e29b-41d4-a716-446655440000 - error: code: rate_limit_exceeded message: Rate limit exceeded (per hour) request_id: 550e8400-e29b-41d4-a716-446655440001 - error: code: rate_limit_exceeded message: Too many failed authentication attempts. Please try again later. request_id: 550e8400-e29b-41d4-a716-446655440002 Error500: $ref: '#/components/schemas/Error' description: Internal server error response examples: - error: code: internal_error message: An unexpected error occurred. Please try again later. request_id: 550e8400-e29b-41d4-a716-446655440000 Error502: $ref: '#/components/schemas/Error' description: >- The upstream source answered, but with data this endpoint cannot process — for example a response schema the source has retired. Unlike 503 this is deterministic: the same request will keep failing until a fix ships, so it never carries Retry-After and retrying only burns credits. These are alerted on automatically. examples: - error: code: upstream_contract_broken message: >- The upstream source returned data this endpoint cannot process. This is not retryable; it has been reported. request_id: 550e8400-e29b-41d4-a716-446655440000 details: upstream_error: upstream_contract_broken retryable: false Error503: $ref: '#/components/schemas/Error' description: >- Service temporarily unavailable. Check Retry-After when present and retry with bounded backoff. examples: - error: code: service_unavailable message: >- Live Instagram data is temporarily unavailable. Please retry shortly. request_id: 550e8400-e29b-41d4-a716-446655440000 details: retry_after_seconds: 60 upstream_error: upstream_rate_limited Error: type: object properties: error: type: object properties: code: $ref: '#/components/schemas/ErrorCode' description: Machine-readable error code message: type: string description: Human-readable error message example: Request validation failed status_code: description: >- HTTP status code repeated for clients that consume the error body example: 402 type: integer minimum: -9007199254740991 maximum: 9007199254740991 param: description: Parameter that caused the error (if applicable) example: query type: string request_id: description: >- Optional request ID for debugging. Read the X-Request-Id response header when absent. example: 550e8400-e29b-41d4-a716-446655440000 type: string details: description: Structured error context (e.g., field-level validation issues) type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false required: - error additionalProperties: false Error402: type: object properties: error: type: object properties: code: type: string const: payment_required message: type: string status_code: type: number const: 402 reason_code: type: string enum: - BILLING_SUSPENDED - PAYMENT_FAILED - PAYMENT_ACTION_REQUIRED - DISPUTE_OPENED - NO_PAYMENT_METHOD - SUBSCRIPTION_REQUIRED - NO_BUNDLE_CONFIGURED - BUNDLE_EXHAUSTED next_step: type: string enum: - update_payment_method - complete_authentication - contact_support - add_payment_method - reconnect_connection - upgrade_plan request_id: type: string details: type: object propertyNames: type: string additionalProperties: {} required: - code - message - status_code - reason_code - next_step additionalProperties: false required: - error additionalProperties: false description: >- Payment required response. Returned when account billing or a subscription bundle requires attention. examples: - error: code: payment_required message: Payment authentication is required. status_code: 402 reason_code: PAYMENT_ACTION_REQUIRED next_step: complete_authentication request_id: 550e8400-e29b-41d4-a716-446655440000 ErrorInsufficientCredits: type: object properties: error: type: object properties: code: type: string const: insufficient_credits message: type: string status_code: type: number const: 402 request_id: type: string details: type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false required: - error additionalProperties: false description: >- Remaining credits cannot cover this request. Add a payment method to continue. Do not retry automatically. examples: - error: code: insufficient_credits message: >- Not enough credits remaining for this search. Add a payment method to continue. details: remaining: 10 required: 75 add_payment_method: true ErrorCode: type: string enum: - validation_error - invalid_parameter - missing_parameter - unauthorized - forbidden - payment_required - insufficient_credits - not_found - rate_limit_exceeded - quota_exceeded - internal_error - service_unavailable - upstream_contract_broken - database_error - seed_not_found - invalid_seeds - seed_resolution_failed - lookalike_failed - get_profiles_failed - post_analysis_failed - match_failed - scraping_failed - transcript_unavailable - transcript_not_available - transcription_limit_exceeded - transcription_unavailable description: Machine-readable error code for programmatic handling example: validation_error securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.