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. See 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.

A changed or invalid source response returns 502 upstream_contract_broken. Do not automatically retry this response. Neither an ambiguous empty response nor a query execution error confirms that an account was deleted.

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.

Available recent posts include photos, carousels, and videos. An unavailable total profile media count is returned as media_count: null; an unavailable video view count is omitted. Preserve previously known metrics rather than substituting zero. posts.length counts this response, not the profile total.

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)

GET /v1/raw/instagram/profile/{username}

cURL

cURL

curl --request GET \
  --url https://api.influship.com/v1/raw/instagram/profile/{username} \
  --header 'X-API-Key: <api-key>'

200

{
  "data": {
    "username": "<string>",
    "user_id": "<string>",
    "full_name": "<string>",
    "biography": "<string>",
    "follower_count": 123,
    "following_count": 123,
    "media_count": 123,
    "is_verified": true,
    "is_private": true,
    "profile_pic_url": "<string>",
    "external_url": "<string>",
    "bio_links": [
      {
        "title": "<string>",
        "url": "<string>",
        "link_type": "<string>"
      }
    ],
    "pronouns": [
      "<string>"
    ],
    "category_name": "<string>",
    "engagement_rate": 123,
    "posts": [
      {
        "id": "<string>",
        "shortcode": "<string>",
        "display_url": "<string>",
        "is_video": true,
        "post_type": "image",
        "like_count": 123,
        "comment_count": 123,
        "caption": "<string>",
        "taken_at": 123,
        "owner_username": "<string>",
        "accessibility_caption": "<string>",
        "video_url": "<string>",
        "thumbnail_url": "<string>",
        "view_count": 123,
        "carousel_items": [
          {
            "index": 123,
            "display_url": "<string>",
            "is_video": true,
            "video_url": "<string>",
            "thumbnail_url": "<string>"
          }
        ],
        "coauthor_usernames": [
          "<string>"
        ],
        "is_paid_partnership": true,
        "sponsor_usernames": [
          "<string>"
        ],
        "tagged_usernames": [
          "<string>"
        ],
        "product_mentions": [
          {
            "product_id": "<string>",
            "product_name": "<string>",
            "merchant_username": "<string>"
          }
        ],
        "display_resources": [
          {
            "src": "<string>",
            "config_width": 123,
            "config_height": 123
          }
        ],
        "video_versions": [
          {
            "url": "<string>",
            "id": "<string>",
            "type": 123,
            "width": 123,
            "height": 123
          }
        ],
        "music_attribution": {
          "artist_name": "<string>",
          "song_name": "<string>",
          "audio_id": "<string>",
          "uses_original_audio": true,
          "should_mute_audio": true
        },
        "location": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>",
          "has_public_page": true,
          "lat": 123,
          "lng": 123,
          "address_json": {}
        },
        "is_pinned": true,
        "engagement_visibility": {
          "viewer_can_reshare": true,
          "comments_disabled": true,
          "like_and_view_counts_disabled": true
        }
      }
    ],
    "related_profiles": [
      {
        "username": "<string>",
        "full_name": "<string>",
        "profile_pic_url": "<string>",
        "is_verified": true,
        "is_private": true
      }
    ],
    "scraped_at": "2023-11-07T05:31:56Z",
    "profile_pic_url_hd": "<string>"
  }
}

Authorizations

X-API-Key · string · header · required

Path Parameters

username · string · required

Username on the platform

Required string length: 1 - 50

Example:

"fitness_coach_jane"

Query Parameters

include_posts · boolean

Include recent posts in response

Example:

true

post_limit · integer · default: 12

Number of posts to include

Required range: 1 <= x <= 50

Example:

12

Response

200

application/json

Successful response

data · object · required

Show child attributes