> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Profile Information
> Retrieve basic profile information of a specified Instagram creator, including metadata such as follower count, account type, language, hashtags, and more.
Optionally pass `fields` in the request body to return only a subset of profile fields. You are billed the sum of the requested fields' costs, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, requests that include a fields parameter return a `400` error (`FractionalCallsNotEnabled`). Per-field pricing is not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls).
## OpenAPI
````yaml /api-v3/api-v3.yaml post /instagram/profile
openapi: 3.1.0
info:
version: 1.0.0
title: CreatorDB Headless API V3
description: '# CreatorDB Headless API V3'
contact:
name: CreatorDB
url: https://www.creatordb.app
email: support@creatordb.app
license:
url: http://www.apache.org/licenses/LICENSE-2.0.html
name: Apache 2.0
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
security:
- ApiKeyAuth: []
tags:
- name: Brand
description: Brand analysis endpoints including sponsor search and brand reports.
- name: Facebook
description: Facebook creator data endpoints with metrics and search capabilities.
- name: General Operations
description: >-
General-purpose endpoints such as API status, content retrieval, and
cross-platform operations.
- name: Instagram
description: >-
Instagram creator data endpoints with metrics and advanced search
capabilities.
- name: Niches
description: >-
Niche-related endpoints for content category analysis and related
searches.
- name: Threads
description: Threads creator data endpoints with basic metrics and historical data.
- name: TikTok
description: >-
TikTok creator data endpoints with metrics and advanced search
functionality.
- name: Topic
description: Topic-based analysis and reporting endpoints for content categorization.
- name: YouTube
description: >-
YouTube creator data endpoints including basic metrics, historical data,
and detailed analytics.
paths:
/instagram/profile:
post:
tags:
- Instagram
summary: Get Profile Information
description: >-
Retrieve basic profile information of a specified Instagram creator,
including metadata such as follower count, account type, language,
hashtags, and more.
Optionally pass `fields` in the request
body to return only a subset of profile fields. You are billed the sum
of the requested fields' costs, capped at the full-bundle price.
Fractional calls must be enabled on your API key. Otherwise, requests
that include a fields parameter return a `400` error
(`FractionalCallsNotEnabled`). Per-field pricing is not published yet.
For how fractional calls work, see [Fractional
Calls](/api-v3/fractional-calls).
operationId: getInstagramProfile
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- uniqueId
properties:
uniqueId:
type: string
description: >-
Instagram account ID. Accepts `instagram` or `@instagram`
format (@ is stripped automatically).
pattern: ^@?[a-zA-Z0-9._]+$
minLength: 1
maxLength: 31
examples:
- instagram
fields:
type: array
description: >-
Subset of profile fields to return for fractional billing.
Omit or pass an empty array to return the full profile at
the full-bundle price. Per-field costs are not published
yet.
items:
type: string
examples:
- - displayName
- country
- totalFollowers
responses:
'200':
description: Instagram creator profile information returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
description: Profile information of the specified Instagram creator.
properties:
uniqueId:
type: string
description: The Instagram handle.
examples:
- instagram
displayName:
type: string
description: The Instagram account name.
examples:
- Instagram
category:
type: string
description: The professional account category.
examples:
- Art
avatarUrl:
type: string
description: The profile picture URL.
format: uri
examples:
- >-
https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/500169417_18514151086053040_2166230648120544979_n.jpg
bio:
type: string
description: The profile biography.
examples:
- Capture and share the world's moments
isBusinessAccount:
type: boolean
description: '`true` if it is a business account.'
examples:
- false
isPrivateAccount:
type: boolean
description: '`true` if it is a private account.'
examples:
- false
isVerified:
type: boolean
description: '`true` if it is verified by Instagram.'
examples:
- true
hasSponsors:
type: boolean
description: '`true` if there is sponsored content.'
examples:
- true
country:
type: string
description: >-
The country in **ISO 3166-1 alpha-3** format. For the
country code list, see
[here](https://docs.creatordb.app/api-v2/country-code).
examples:
- TWN
mainLanguage:
type: string
description: >-
The primary language used in posts, represented in
**ISO 639-3** format. For the language code list, see
[here](https://docs.creatordb.app/api-v3/language-code).
examples:
- zht
languages:
type: array
description: >-
All languages used in posts, represented in **ISO
639-3** format. For the language code list, see
[here](https://docs.creatordb.app/api-v3/language-code).
examples:
- - zht
- eng
items:
type: string
secondLanguage:
type: string
description: >-
The secondary language used in posts, represented in
**ISO 639-3** format. For language code list, see
[here](https://docs.creatordb.app/api-v3/language-code).
examples:
- eng
totalContents:
type: integer
description: Total number of image posts and reels.
minimum: 0
examples:
- 1609
totalFollowers:
type: integer
description: Total number of followers.
minimum: 0
examples:
- 613344
totalFollowing:
type: integer
description: Total number of accounts followed.
minimum: 0
examples:
- 1204
subscriberGrowth:
type: object
description: >-
Follower growth metrics over 7, 30, and 90-day
periods.
properties:
g7:
type: number
description: >-
Follower growth over 7 days, rounded to 4th
decimal place.
examples:
- 0.1234
g30:
type: number
description: >-
Follower growth over 30 days, rounded to 4th
decimal place.
examples:
- 0.2345
g90:
type: number
description: >-
Follower growth over 90 days, rounded to 4th
decimal place.
examples:
- 0.3456
required:
- g7
- g30
- g90
hashtags:
type: array
description: Hashtags in Instagram content and usage statistics.
items:
type: object
description: Hashtag information and usage statistics.
properties:
name:
type: string
description: Keywords used in post captions or descriptions.
examples:
- '#doubleblackcrew'
contentCount:
type: integer
description: Number of posts using the hashtag.
minimum: 0
examples:
- 33
required:
- name
- contentCount
niches:
type: array
description: >-
Granular subcategories of content topics identified by
CreatorDB's AI model, which analyzes and groups
keywords, hashtags, and tags used by creators.
examples:
- - india_All
- newyear_All
- thailand_All
items:
type: string
otherLinks:
type: array
description: Linked websites.
items:
type: object
description: Information of external platform links.
properties:
title:
type: string
description: The link name.
examples:
- TikTok
url:
type: string
description: URL of the social media profile page.
format: uri
examples:
- https://www.tiktok.com/@tiktok
required:
- title
- url
lastPublishTime:
type: integer
description: >-
Time of the last uploaded content, represented as a
Unix timestamp in milliseconds.
examples:
- 1753179002000
relatedCreators:
type: array
description: Creators recommended by Instagram.
examples:
- - tiktok
- youtube
- meta
items:
type: string
lastDbUpdateTime:
type: integer
description: >-
Last update time of the creator profile and statistics
in the CreatorDB database, represented as a Unix
timestamp in milliseconds.
examples:
- 1755309755899
required:
- uniqueId
- displayName
- category
- avatarUrl
- bio
- isBusinessAccount
- isPrivateAccount
- isVerified
- hasSponsors
- country
- mainLanguage
- languages
- secondLanguage
- totalContents
- totalFollowers
- totalFollowing
- subscriberGrowth
- hashtags
- niches
- otherLinks
- lastPublishTime
- relatedCreators
- lastDbUpdateTime
creditsUsed:
type: integer
description: Number of API credits consumed by this request.
examples:
- 1
creditsAvailable:
type: integer
description: Number of API credits remaining.
examples:
- -1
traceId:
type: string
description: Unique trace ID for each request.
examples:
- f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
timestamp:
type: integer
description: >-
Time the response was generated, represented as a Unix
timestamp in milliseconds.
examples:
- 1750732453635
errorCode:
type: string
description: >-
Error code returned if the request fails. Empty if the
request is successful.
examples:
- ''
errorDescription:
type: string
description: >-
Description of the error. Empty if the request is
successful.
examples:
- ''
success:
type: boolean
description: '`true` if the request is successful.'
examples:
- true
required:
- data
- traceId
- timestamp
- errorCode
- errorDescription
- success
- creditsUsed
- creditsAvailable
examples:
default:
value:
data:
uniqueId: cristiano
displayName: Cristiano Ronaldo
category: Sportsperson
avatarUrl: >-
https://instagram.ftpe7-4.fna.fbcdn.net/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-4.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QHtqBG6PlzU9JR2BMFQSEMyTG3ySNQrxXzNbDtoV4jaiwe2ReIgdF8V5E0z2ehh8paPfEaFwBlyq2lB943nq7JF&_nc_ohc=OZ2xUG_Zs_MQ7kNvwFipRgY&_nc_gid=KqYk4e7CABSJyh4CSq_QKg&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_Afq_AmZzttY3DR719tqBCbu2zD5NFHQFvobxIE_8cLmUdg&oe=696401DE&_nc_sid=7d3ac5
bio: SIUUUbscribe to my Youtube Channel!
isBusinessAccount: false
isVerified: true
hasSponsors: false
country: SAU
mainLanguage: eng
totalContents: 3995
totalFollowers: 670646453
totalFollowing: 625
hashtags:
- name: '#cr7fragances'
contentCount: 2
- name: '#cr7energy'
contentCount: 2
- name: '#cr7underwear'
contentCount: 1
- name: '#foreverforward'
contentCount: 1
- name: '#sponsored'
contentCount: 1
- name: '#7heselection'
contentCount: 1
niches:
- id_fitness_All
- id_lifestyle_All
- id_health_All
- id_wellness_All
- id_nutrition_All
- id_cr7_All
- id_cristianoronaldo_All
- id_longevity_All
- id_ramadankareem_All
- id_liveyourbestlife_All
otherLinks:
- title: Perplexity
url: http://perplexity.ai/ronaldo
- title: WHOOP
url: http://join.whoop.com/cr7
- title: AVA
url: https://avacr7.com/en/
- title: UR Cristiano
url: https://youtube.com/@cristiano
lastPublishTime: 1767707453000
relatedCreators:
- erakulis
- cr7lifemuseum
- heidiklum
- rauwalejandro
- liltunechi
- theweeknd
- erakulis.pro
- bellhatria
lastDbUpdateTime: 1767783708328
creditsUsed: 1
creditsAvailable: -1
traceId: 4e143c01006170d2ff95f86e5aaeb400
timestamp: 1767928263490
errorCode: ''
errorDescription: ''
success: true
'400':
description: Validation error.
content:
application/json:
schema:
type: object
title: ValidationErrorResponse
properties:
success:
const: false
error:
type: string
message:
type: string
timestamp:
type: integer
required:
- success
- error
- message
- timestamp
examples:
missing uniqueId:
summary: Missing uniqueId
value:
success: false
error: VALIDATION_ERROR
message: 'Missing required field: ''uniqueId''.'
timestamp: 1770099403116
invalid uniqueId:
summary: Invalid uniqueId format
value:
success: false
error: VALIDATION_ERROR
message: >-
Invalid 'uniqueId' format. Instagram unique IDs must be
between 1 and 31 characters.
timestamp: 1770099403116
'429':
description: Exceeded quota or rate limit.
content:
application/json:
schema:
type: object
title: QuotaErrorResponse
properties:
success:
const: false
error:
type: string
message:
type: string
remainingPlanCredit:
type: number
required:
- success
- error
- message
- remainingPlanCredit
examples:
rate limit:
summary: Rate limit exceeded
value:
success: false
error: RATE_LIMIT_EXCEEDED
message: Too many requests. Please try again later.
quota exceeded:
summary: Credit quota exceeded
value:
success: false
error: QUOTA_EXCEEDED
message: Not enough credits to complete this request.
security:
- ApiKeyAuth: []
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
x-codeSamples:
- lang: bash
label: cURL
source: |
curl -X POST "https://apiv3.creatordb.app/instagram/profile" \
-H "Content-Type: application/json" \
-H "api-key: " \
-d '{ "uniqueId": "cristiano", "fields": ["displayName", "country"] }'
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````