> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scraper.creatorlookup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Profile

> Retrieve an Instagram user's profile data

## Request

### Headers

| Name        | Required | Description  |
| ----------- | -------- | ------------ |
| `x-api-key` | Yes      | Your API key |

### Query parameters

<ParamField query="username" type="string" required>
  The Instagram username to look up (without the @ symbol).
</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="InstagramProfile">
    <ResponseField name="id" type="string">Instagram numeric user ID</ResponseField>
    <ResponseField name="username" type="string">Instagram username</ResponseField>
    <ResponseField name="full_name" type="string">Display name</ResponseField>
    <ResponseField name="biography" type="string">Bio text</ResponseField>
    <ResponseField name="follower_count" type="number">Number of followers</ResponseField>
    <ResponseField name="following_count" type="number">Number of accounts followed</ResponseField>
    <ResponseField name="media_count" type="number">Total posts</ResponseField>
    <ResponseField name="profile_pic_url" type="string">Profile picture URL</ResponseField>
    <ResponseField name="is_verified" type="boolean">Whether the account has a verified badge</ResponseField>
    <ResponseField name="is_business" type="boolean">Whether this is a business/creator account</ResponseField>
    <ResponseField name="is_professional_account" type="boolean">Whether account is a professional/creator account</ResponseField>
    <ResponseField name="is_private" type="boolean">Whether account is private</ResponseField>
    <ResponseField name="category" type="string | null">Human-readable business category (e.g., "Product/service")</ResponseField>
    <ResponseField name="category_enum" type="string | null">Machine-readable category (e.g., "SPORTSWEAR\_STORE", "CREATOR")</ResponseField>
    <ResponseField name="external_url" type="string | null">Website URL from bio</ResponseField>
    <ResponseField name="contact_email" type="string | null">Public contact email</ResponseField>
    <ResponseField name="contact_phone" type="string | null">Public contact phone</ResponseField>
    <ResponseField name="bio_emails" type="string[]">Email addresses extracted from biography text</ResponseField>

    <ResponseField name="bio_links" type="object[]">
      Links extracted from bio. Each object contains:

      <Expandable title="BioLink">
        <ResponseField name="url" type="string">The link URL</ResponseField>
        <ResponseField name="title" type="string">Display title for the link</ResponseField>
        <ResponseField name="link_type" type="string">Type of link (e.g., "external")</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="highlight_reel_count" type="number">Number of story highlights</ResponseField>
    <ResponseField name="fbid" type="string | null">Linked Facebook page ID</ResponseField>

    <ResponseField name="business_address" type="object | null">
      Business location information (if available).

      <Expandable title="BusinessAddress">
        <ResponseField name="street_address" type="string">Street address</ResponseField>
        <ResponseField name="city_name" type="string">City and state</ResponseField>
        <ResponseField name="zip_code" type="string">Postal/ZIP code</ResponseField>
        <ResponseField name="latitude" type="number">Latitude coordinate</ResponseField>
        <ResponseField name="longitude" type="number">Longitude coordinate</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="credits_used" type="number">Credits deducted (1)</ResponseField>
<ResponseField name="credits_remaining" type="number">Remaining credit balance</ResponseField>

**Cost:** 1 credit

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: sk-your-api-key" \
    "https://api.scraper.creatorlookup.com/v1/instagram/profile?username=instagram"
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://api.scraper.creatorlookup.com/v1/instagram/profile?username=instagram",
    { headers: { "x-api-key": "sk-your-api-key" } }
  );

  const { data, credits_used, credits_remaining } = await res.json();

  console.log(data.username);         // "instagram"
  console.log(data.follower_count);   // 676000000
  console.log(data.is_verified);      // true
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://api.scraper.creatorlookup.com/v1/instagram/profile",
      params={"username": "instagram"},
      headers={"x-api-key": "sk-your-api-key"},
  )

  data = res.json()["data"]
  print(data["username"])         # "instagram"
  print(data["follower_count"])   # 676000000
  print(data["is_verified"])      # True
  ```
</CodeGroup>

### 200 — Success

```json theme={null}
{
  "data": {
    "id": "13460080",
    "username": "nike",
    "full_name": "Nike",
    "biography": "Just Do It.",
    "follower_count": 298148257,
    "following_count": 240,
    "media_count": 1626,
    "profile_pic_url": "https://scontent.cdninstagram.com/...",
    "is_verified": true,
    "is_business": true,
    "is_professional_account": true,
    "is_private": false,
    "category": null,
    "category_enum": "SPORTSWEAR_STORE",
    "external_url": "http://empli.fi/nike",
    "contact_email": null,
    "contact_phone": null,
    "bio_emails": [],
    "bio_links": [
      {
        "url": "http://empli.fi/nike",
        "title": "",
        "link_type": "external"
      }
    ],
    "highlight_reel_count": 5,
    "fbid": "17841400602400210",
    "business_address": {
      "street_address": "One Bowerman Dr",
      "city_name": "Beaverton, Oregon",
      "zip_code": "97005",
      "latitude": 45.5076448,
      "longitude": -122.8269159
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999
}
```

### 402 — Insufficient credits

```json theme={null}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "This endpoint requires 1 credits, you have 0"
  }
}
```

### 502 — Scrape failed

```json theme={null}
{
  "error": {
    "code": "SCRAPE_FAILED",
    "message": "User not found or profile is private"
  }
}
```

### 504 — Timeout

```json theme={null}
{
  "error": {
    "code": "TIMEOUT",
    "message": "Scraping request timed out"
  }
}
```