Instagram

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). For per-field pricing, see Field and Item Costs. For how fractional calls work, see Fractional Calls.

POST

instagram

profile

cURL

curl -X POST "https://apiv3.creatordb.app/instagram/profile" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API-KEY_HERE>" \
  -d '{ "uniqueId": "cristiano", "fields": ["displayName", "country"] }'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({uniqueId: 'instagram', fields: ['displayName', 'country', 'totalFollowers']})
};

fetch('https://apiv3.creatordb.app/instagram/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.creatordb.app/instagram/profile"

payload = {
    "uniqueId": "instagram",
    "fields": ["displayName", "country", "totalFollowers"]
}
headers = {
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/instagram/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uniqueId' => 'instagram',
    'fields' => [
        'displayName',
        'country',
        'totalFollowers'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apiv3.creatordb.app/instagram/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"uniqueId\": \"instagram\",\n  \"fields\": [\n    \"displayName\",\n    \"country\",\n    \"totalFollowers\"\n  ]\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiv3.creatordb.app/instagram/profile"

	payload := strings.NewReader("{\n  \"uniqueId\": \"instagram\",\n  \"fields\": [\n    \"displayName\",\n    \"country\",\n    \"totalFollowers\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/instagram/profile")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"uniqueId\": \"instagram\",\n  \"fields\": [\n    \"displayName\",\n    \"country\",\n    \"totalFollowers\"\n  ]\n}")
  .asString();

{
  "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": 975,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "traceId": "4e143c01006170d2ff95f86e5aaeb400",
  "timestamp": 1767928263490,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

Authorizations

api-key

string

header

required

The valid CreatorDB API key for authentication.

Body

application/json

uniqueId

string

required

Instagram account ID. Accepts instagram or @instagram format (@ is stripped automatically).

Required string length: 1 - 31

Pattern: ^@?[a-zA-Z0-9._]{1,30}$

Example:

"instagram"

fields

enum<string>[]

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. For details, see Field and Item Costs.

Available options:

uniqueId,

displayName,

category,

avatarUrl,

bio,

isBusinessAccount,

isPrivateAccount,

isVerified,

hasSponsors,

country,

mainLanguage,

secondLanguage,

languages,

totalContents,

totalFollowers,

totalFollowing,

subscriberGrowth,

hashtags,

niches,

otherLinks,

lastPublishTime,

relatedCreators,

lastDbUpdateTime

Example:

["displayName", "country", "totalFollowers"]

Response

Instagram creator profile information returned successfully.

data

object

required

Profile information of the specified Instagram creator.

Show child attributes

creditsUsed

number

required

Number of API credits consumed by this request.

Example:

1

creditsAvailable

number

required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

-1

planCreditsAvailable

number

required

Remaining plan credits after this request, in credits.

Example:

900

purchasedCreditsAvailable

number

required

Remaining purchased-bucket credits after this request, in display units.

Example:

75

traceId

string

required

Unique trace ID for each request.

Example:

"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"

timestamp

integer

required

Time the response was generated, represented as a Unix timestamp in milliseconds.

Example:

1750732453635

errorCode

string

required

Error code returned if the request fails. Empty if the request is successful.

Example:

""

errorDescription

string

required

Description of the error. Empty if the request is successful.

Example:

""

success

boolean

required

true if the request is successful.

Example:

true

keyCreditsAvailable

number

Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.

Example:

4975

Last modified on September 10, 2026

⌘I

cURL

curl -X POST "https://apiv3.creatordb.app/instagram/profile" \
  -H "Content-Type: application/json" \
  -H "api-key: <YOUR_API-KEY_HERE>" \
  -d '{ "uniqueId": "cristiano", "fields": ["displayName", "country"] }'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({uniqueId: 'instagram', fields: ['displayName', 'country', 'totalFollowers']})
};

fetch('https://apiv3.creatordb.app/instagram/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.creatordb.app/instagram/profile"

payload = {
    "uniqueId": "instagram",
    "fields": ["displayName", "country", "totalFollowers"]
}
headers = {
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/instagram/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'uniqueId' => 'instagram',
    'fields' => [
        'displayName',
        'country',
        'totalFollowers'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apiv3.creatordb.app/instagram/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"uniqueId\": \"instagram\",\n  \"fields\": [\n    \"displayName\",\n    \"country\",\n    \"totalFollowers\"\n  ]\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiv3.creatordb.app/instagram/profile"

	payload := strings.NewReader("{\n  \"uniqueId\": \"instagram\",\n  \"fields\": [\n    \"displayName\",\n    \"country\",\n    \"totalFollowers\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/instagram/profile")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"uniqueId\": \"instagram\",\n  \"fields\": [\n    \"displayName\",\n    \"country\",\n    \"totalFollowers\"\n  ]\n}")
  .asString();

{
  "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": 975,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "traceId": "4e143c01006170d2ff95f86e5aaeb400",
  "timestamp": 1767928263490,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

Getting Started

User Guides

API Endpoints

Filter Value References

Troubleshooting and FAQs

Get Profile Information

Authorizations

Body

Response