Skip to content
All Instagram APIs
Accounts & creatorsInstagramUser · Profile

Instagram user profile

Read a public Instagram account's bio, links, verification, and follower and following counts by username.

POST/v1/instagram/users/profile

Chinese name: Instagram 用户资料 · 用户 · 资料 按用户名读取一位 Instagram 公开账号的简介、链接、认证状态和粉丝、关注数。
instagram.users.profile@v1

Price at launch

¥0.02/ call

Nothing is charged before launch.

Current statusComing soonChecking live status
Available to try at launch

Try it

This API is coming soon

We are running launch checks. Once live, you can try it right here at the price shown above; nothing is charged before then. You can already read the parameters and response example.

Request parameters

usernamestringrequired

pattern: "^[A-Za-z0-9._]{1,30}$" · minLength: 1 · maxLength: 256

Example: "instagram"

Request JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "username": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[A-Za-z0-9._]{1,30}$"
    }
  },
  "required": [
    "username"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/instagram/users/profile \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"username":"instagram"}'

Response example

200 · application/json
{
  "code": 200,
  "request_id": "req_example_instagram_users_profile",
  "message": "success",
  "data": {
    "item": {
      "id": "25025320",
      "username": "instagram",
      "full_name": "Instagram",
      "biography": "Discover what's new on Instagram.",
      "edge_followed_by": {
        "count": 690000000
      },
      "edge_follow": {
        "count": 200
      },
      "is_private": false,
      "is_verified": true
    }
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "instagram.users.profile",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.02",
    "balance_after": "49.98",
    "currency": "CNY"
  }
}
Response fields
codenumber
const: 200
request_idstring
messagestring
const: "success"
dataobject
pageobject
warningsarray
metaobject
Response JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "item": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "id": {},
                "username": {},
                "full_name": {},
                "biography": {},
                "bio_links": {},
                "external_url": {},
                "edge_followed_by": {},
                "edge_follow": {},
                "is_private": {},
                "is_verified": {},
                "is_business_account": {},
                "is_professional_account": {},
                "highlight_reel_count": {}
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "item"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "instagram.users.profile"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

  • Use it when you know an Instagram username and need the public profile and scale.

Not for

  • Do not use it for private-account content, stories, DMs, or signed-in data.

Known limitations

  • Follower and following counts are under edge_followed_by.count and edge_follow.count.
  • Usernames can change; store the returned id for long-term tracking.
  • Counts are point-in-time public snapshots, not live or historical trends.

Billing

¥0.02 per call. Nonempty complete results are charged; empty, partial, and failed results are not.

See all pricing →