> ## 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 Performance History
> Retrieve daily performance snapshots for a specified Instagram creator within a specific period, including upload activity, follower growth, engagement metrics, and post or reel performance. Dates are returned as Unix timestamps in milliseconds.
## OpenAPI
````yaml /api-v3/api-v3.yaml get /instagram/performance-history
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/performance-history:
get:
tags:
- Instagram
summary: Get Performance History
description: >-
Retrieve daily performance snapshots for a specified Instagram creator
within a specific period, including upload activity, follower growth,
engagement metrics, and post or reel performance. Dates are returned as
Unix timestamps in milliseconds.
operationId: getInstagramPerformanceHistory
parameters:
- name: uniqueId
in: query
description: >-
Instagram account ID. Accepts `instagram` or `@instagram` format (@
is stripped automatically).
required: true
schema:
type: string
pattern: ^@?[a-zA-Z0-9._]+$
minLength: 1
maxLength: 31
examples:
- instagram
examples:
default:
value: instagram
- name: pastDayRange
in: query
description: >-
Returns one data point per day over the requested range. For
example, `30` returns the past 30 days of daily snapshots. Valid
range: `1`-`365`.
required: true
schema:
type: string
pattern: ^[1-9]\d*$
examples:
- '30'
responses:
'200':
description: Instagram performance historical data returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
description: >-
The historical performance metrics of the specified
Instagram account.
properties:
histories:
type: array
description: >-
Historical performance snapshots, each containing
metrics and a corresponding Unix timestamp in
milliseconds.
items:
type: object
description: >-
A snapshot of the performance metrics on the
specified date.
properties:
timestamp:
type: integer
description: >-
The performance snapshot date, represented as a
Unix timestamp in milliseconds.
exclusiveMinimum: 0
examples:
- 1750732453635
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
totalContents:
type: integer
description: Total number of posts.
minimum: 0
examples:
- 1609
imagesPerformanceRecent:
type: object
description: >-
Performance metrics of the image posts for the
specified time period.
properties:
likes:
type: object
properties:
all:
type: integer
description: Total number of likes.
minimum: 0
examples:
- 2459
avg:
type: integer
description: >-
Average number of likes per image post,
rounded to an integer.
minimum: 0
examples:
- 100
median:
type: integer
description: Median number of likes.
minimum: 0
examples:
- 120
min:
type: integer
description: Minimum number of likes.
minimum: 0
examples:
- 50
max:
type: integer
description: Maximum number of likes.
minimum: 0
examples:
- 988
required:
- all
- avg
- median
- min
- max
comments:
type: object
properties:
all:
type: integer
description: Total number of comments.
minimum: 0
examples:
- 2459
avg:
type: integer
description: >-
Average number of comments per image
post, rounded to an integer.
minimum: 0
examples:
- 100
median:
type: integer
description: Median number of comments.
minimum: 0
examples:
- 120
min:
type: integer
description: Minimum number of comments.
minimum: 0
examples:
- 50
max:
type: integer
description: Maximum number of comments.
minimum: 0
examples:
- 988
required:
- all
- avg
- median
- min
- max
engagement:
type: object
description: >-
Engagement performance metrics including
rates, per-follower statistics, and
consistency analysis.
properties:
avgEngagementRate:
type: number
description: >-
Average engagement rate per Instagram
image post (excluding older pinned image
posts), rounded to 4th decimal place.
- *Engagement Rate = (Likes + Comments)/ Followers*
minimum: 0
examples:
- 0.5201
likesPerFollower:
type: number
description: >-
Average number of likes per follower,
rounded to 4th decimal place.
minimum: 0
examples:
- 0.1111
commentsPerFollower:
type: number
description: >-
Average number of comments per follower,
rounded to 4th decimal place.
minimum: 0
examples:
- 0.1111
engagementConsistency:
type: object
description: Consistency of engagement performance.
properties:
cv:
type: number
description: >-
*cv = Standard Deviation of
Engagement Rate/ Mean Engagement Rate*
- The value is rounded to 4th decimal
place.
- Lower values indicate more consistent
performance.
- *A value of `0` indicates insufficient
data.*
minimum: 0
examples:
- 0.5201
medianVsMean:
type: number
description: >-
*medianVsMean = Median Engagement
Rate/ Mean Engagement Rate*
- The value is rounded to 4th decimal
place.
- Values closer to `1` indicate more
consistent performance.
- *A value of `0` indicates insufficient
data.*
minimum: 0
examples:
- 0.9001
topBottomRatio:
type: number
description: >-
*topBottomRatio = avg(Top 3
Engagement)/avg(Bottom 3 Engagement)*
- The value is rounded to 4th decimal
place.
- Lower ratios indicate more consistent
performance.
- *A value of `0` indicates insufficient
data.*
minimum: 0
examples:
- 1.2001
consistencyScore:
type:
- integer
- 'null'
description: >-
*consistencyScore = 100 -
[(cvScore\*weight_cv) +
(topBottomScore\*weight_topBottom) +
(medianVsMeanScore\*weight_medianVsMean)]*
- The score is rounded to an integer.
- A higher score indicates more stable
and consistent performance.
- Returns `null` when any of the three
indicators (`cv`, `medianVsMean`,
`topBottomRatio`) is `0`, indicating
insufficient data.
minimum: 0
maximum: 100
examples:
- 63
consistencyLevel:
type: string
enum:
- high
- moderate
- low
- null
description: >-
A qualitative label based on the
`consistencyScore`:
- high: 81 - 100
- moderate: 51 - 80
- low: 1 - 50
- Returns `null` when `consistencyScore`
is `null`, indicating insufficient data.
examples:
- moderate
required:
- cv
- medianVsMean
- topBottomRatio
- consistencyScore
- consistencyLevel
required:
- avgEngagementRate
- likesPerFollower
- commentsPerFollower
- engagementConsistency
required:
- likes
- comments
- engagement
reelsPerformanceRecent:
type: object
description: >-
The Instagram reels performance metrics for the
specified time period.
properties:
likes:
type: object
properties:
all:
type: integer
description: Total number of likes.
minimum: 0
examples:
- 2459
avg:
type: integer
description: >-
Average number of likes per Instagram
reel, rounded to an integer.
minimum: 0
examples:
- 100
median:
type: integer
description: Median number of likes.
minimum: 0
examples:
- 120
min:
type: integer
description: Minimum number of likes.
minimum: 0
examples:
- 50
max:
type: integer
description: Maximum number of likes.
minimum: 0
examples:
- 988
required:
- all
- avg
- median
- min
- max
comments:
type: object
properties:
all:
type: integer
description: Total number of comments.
minimum: 0
examples:
- 2459
avg:
type: integer
description: >-
Average number of comments per Instagram
reel, rounded to an integer.
minimum: 0
examples:
- 100
median:
type: integer
description: Median number of comments.
minimum: 0
examples:
- 120
min:
type: integer
description: Minimum number of comments.
minimum: 0
examples:
- 50
max:
type: integer
description: Maximum number of comments.
minimum: 0
examples:
- 988
required:
- all
- avg
- median
- min
- max
views:
type: object
properties:
all:
type: integer
description: Total number of views.
minimum: 0
examples:
- 2459
avg:
type: integer
description: >-
Average number of views per Instagram
reel, rounded to an integer.
minimum: 0
examples:
- 100
median:
type: integer
description: Median number of views.
minimum: 0
examples:
- 120
min:
type: integer
description: Minimum number of views.
minimum: 0
examples:
- 50
max:
type: integer
description: Maximum number of views.
minimum: 0
examples:
- 988
required:
- all
- avg
- median
- min
- max
engagement:
type: object
description: >-
Engagement performance metrics for Instagram
reels.
properties:
avgEngagementRate:
type: number
description: >-
Average engagement rate per Instagram
reel (excluding older pinned reels),
rounded to 4th decimal place.
- *Engagement Rate = (Likes + Comments) / Followers*
minimum: 0
examples:
- 0.5201
likesPerFollower:
type: number
description: >-
Average number of likes per follower,
rounded to 4th decimal place.
minimum: 0
examples:
- 0.1111
commentsPerFollower:
type: number
description: >-
Average number of comments per follower,
rounded to 4th decimal place.
minimum: 0
examples:
- 0.1111
viewsPerFollower:
type: number
description: >-
Average number of views per follower,
rounded to 4th decimal place.
minimum: 0
examples:
- 0.1111
engagementConsistency:
type: object
description: >-
Consistency of engagement performance
across Instagram reels.
properties:
cv:
type: number
description: >-
*cv = Standard Deviation of
Engagement Rate/ Mean Engagement Rate*
- The value is rounded to 4th decimal
place.
- Lower values indicate more consistent
performance.
- *A value of `0` indicates insufficient
data.*
minimum: 0
examples:
- 0.5201
medianVsMean:
type: number
description: >-
*medianVsMean = Median Engagement
Rate/ Mean Engagement Rate*
- The value is rounded to 4th decimal
place.
- Values closer to `1` indicate more
consistent performance.
- *A value of `0` indicates insufficient
data.*
minimum: 0
examples:
- 0.9001
topBottomRatio:
type: number
description: >-
*topBottomRatio = avg(Top 3
Engagement)/avg(Bottom 3 Engagement)*
- The value is rounded to 4th decimal
place.
- Lower ratios indicate more consistent
performance.
- *A value of `0` indicates insufficient
data.*
minimum: 0
examples:
- 1.2001
consistencyScore:
type:
- integer
- 'null'
description: >-
*consistencyScore = 100 -
[(cvScore\*weight_cv) +
(topBottomScore\*weight_topBottom) +
(medianVsMeanScore\*weight_medianVsMean)]*
- The score is rounded to an integer.
- A higher score indicates more stable
and consistent performance.
- Returns `null` when any of the three
indicators (`cv`, `medianVsMean`,
`topBottomRatio`) is `0`, indicating
insufficient data.
minimum: 0
maximum: 100
examples:
- 63
consistencyLevel:
type: string
enum:
- high
- moderate
- low
- null
description: >-
A qualitative label based on the
`consistencyScore`:
- high: 81 - 100
- moderate: 51 - 80
- low: 1 - 50
- Returns `null` when `consistencyScore`
is `null`, indicating insufficient data.
examples:
- moderate
required:
- cv
- medianVsMean
- topBottomRatio
- consistencyScore
- consistencyLevel
required:
- avgEngagementRate
- likesPerFollower
- commentsPerFollower
- viewsPerFollower
- engagementConsistency
required:
- likes
- comments
- views
- engagement
required:
- timestamp
- totalFollowers
- totalFollowing
- totalContents
- imagesPerformanceRecent
- reelsPerformanceRecent
required:
- histories
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:
histories:
- timestamp: 1767934923420
totalFollowers: 670701146
totalFollowing: 625
totalContents: 3996
imagesPerformanceRecent:
likes:
all: 129460053
avg: 6813687
median: 4971626
min: 967242
max: 28938447
comments:
all: 1454317
avg: 76543
median: 44385
min: 9838
max: 402754
engagement:
avgEngagementRate: 0.0103
likesPerFollower: 0.0102
commentsPerFollower: 0.0001
engagementConsistency:
cv: 0.9764
medianVsMean: 0.7283
topBottomRatio: 11.6484
consistencyScore: 37
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 53411784
avg: 4450982
median: 1885484
min: 735003
max: 18386191
comments:
all: 1200876
avg: 100073
median: 31761
min: 9965
max: 631039
views:
all: 1075622364
avg: 89635197
median: 49017380
min: 34884947
max: 250628732
engagement:
avgEngagementRate: 0.0401
likesPerFollower: 0.0066
commentsPerFollower: 0.0001
viewsPerFollower: 0.1336
engagementConsistency:
cv: 0.4417
medianVsMean: 0.9014
topBottomRatio: 3.0797
consistencyScore: 56
consistencyLevel: moderate
- timestamp: 1767762123420
totalFollowers: 670646453
totalFollowing: 625
totalContents: 3995
imagesPerformanceRecent:
likes:
all: 132415140
avg: 6620757
median: 4925652
min: 962496
max: 28938630
comments:
all: 1474100
avg: 73705
median: 40749
min: 9810
max: 402810
engagement:
avgEngagementRate: 0.01
likesPerFollower: 0.0099
commentsPerFollower: 0.0001
engagementConsistency:
cv: 0.9832
medianVsMean: 0.7414
topBottomRatio: 11.6358
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 53196840
avg: 4433070
median: 1883337
min: 730553
max: 18364260
comments:
all: 1198032
avg: 99836
median: 31721
min: 9902
max: 630613
views:
all: 1071241248
avg: 89270104
median: 48941749
min: 34797482
max: 250347282
engagement:
avgEngagementRate: 0.0401
likesPerFollower: 0.0066
commentsPerFollower: 0.0001
viewsPerFollower: 0.1331
engagementConsistency:
cv: 0.4435
medianVsMean: 0.9003
topBottomRatio: 3.0964
consistencyScore: 56
consistencyLevel: moderate
- timestamp: 1767589323420
totalFollowers: 670597778
totalFollowing: 623
totalContents: 3994
imagesPerformanceRecent:
likes:
all: 131768280
avg: 6588414
median: 4921587
min: 956629
max: 28937300
comments:
all: 1467760
avg: 73388
median: 40549
min: 9786
max: 402852
engagement:
avgEngagementRate: 0.0099
likesPerFollower: 0.0098
commentsPerFollower: 0.0001
engagementConsistency:
cv: 0.9878
medianVsMean: 0.7444
topBottomRatio: 11.6479
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 52942068
avg: 4411839
median: 1880724
min: 725025
max: 18339536
comments:
all: 1194936
avg: 99578
median: 31710
min: 9798
max: 630010
views:
all: 1067087196
avg: 88923933
median: 48862281
min: 34706357
max: 250055783
engagement:
avgEngagementRate: 0.04
likesPerFollower: 0.0066
commentsPerFollower: 0.0001
viewsPerFollower: 0.1326
engagementConsistency:
cv: 0.4446
medianVsMean: 0.9003
topBottomRatio: 3.1075
consistencyScore: 56
consistencyLevel: moderate
- timestamp: 1767502923420
totalFollowers: 670481059
totalFollowing: 623
totalContents: 3994
imagesPerformanceRecent:
likes:
all: 129735900
avg: 6486795
median: 4759869
min: 952213
max: 28935561
comments:
all: 1440060
avg: 72003
median: 36859
min: 9740
max: 402870
engagement:
avgEngagementRate: 0.0098
likesPerFollower: 0.0097
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0055
medianVsMean: 0.7307
topBottomRatio: 11.6489
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 52622760
avg: 4385230
median: 1878046
min: 720368
max: 18302670
comments:
all: 1191012
avg: 99251
median: 31654
min: 9612
max: 629453
views:
all: 1061905140
avg: 88492095
median: 48778214
min: 34603902
max: 249646001
engagement:
avgEngagementRate: 0.04
likesPerFollower: 0.0065
commentsPerFollower: 0.0001
viewsPerFollower: 0.132
engagementConsistency:
cv: 0.4452
medianVsMean: 0.9002
topBottomRatio: 3.1146
consistencyScore: 56
consistencyLevel: moderate
- timestamp: 1767330123420
totalFollowers: 670424895
totalFollowing: 623
totalContents: 3994
imagesPerformanceRecent:
likes:
all: 125632294
avg: 6612226
median: 4767082
min: 947369
max: 28935723
comments:
all: 1407444
avg: 74076
median: 37262
min: 9710
max: 402844
engagement:
avgEngagementRate: 0.01
likesPerFollower: 0.0099
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0075
medianVsMean: 0.7206
topBottomRatio: 11.6901
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 52282284
avg: 4356857
median: 1875600
min: 715285
max: 18263833
comments:
all: 1187280
avg: 98940
median: 31602
min: 9553
max: 628816
views:
all: 1056432804
avg: 88036067
median: 48687463
min: 34492908
max: 249204401
engagement:
avgEngagementRate: 0.04
likesPerFollower: 0.0065
commentsPerFollower: 0.0001
viewsPerFollower: 0.1313
engagementConsistency:
cv: 0.4456
medianVsMean: 0.9005
topBottomRatio: 3.1209
consistencyScore: 55
consistencyLevel: moderate
- timestamp: 1767157323420
totalFollowers: 670189480
totalFollowing: 623
totalContents: 3993
imagesPerformanceRecent:
likes:
all: 119280942
avg: 6626719
median: 4752101
min: 935533
max: 28934893
comments:
all: 1343376
avg: 74632
median: 36863
min: 9619
max: 402837
engagement:
avgEngagementRate: 0.01
likesPerFollower: 0.0099
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0286
medianVsMean: 0.714
topBottomRatio: 11.6896
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 47129665
avg: 4284515
median: 1676707
min: 704575
max: 18218909
comments:
all: 1132065
avg: 102915
median: 18919
min: 9471
max: 628030
views:
all: 970460920
avg: 88223720
median: 46089249
min: 34281432
max: 248650530
engagement:
avgEngagementRate: 0.038
likesPerFollower: 0.0064
commentsPerFollower: 0.0002
viewsPerFollower: 0.1316
engagementConsistency:
cv: 0.4562
medianVsMean: 0.9324
topBottomRatio: 2.9163
consistencyScore: 55
consistencyLevel: moderate
- timestamp: 1766984523420
totalFollowers: 670029165
totalFollowing: 623
totalContents: 3991
imagesPerformanceRecent:
likes:
all: 118917144
avg: 6606508
median: 4743719
min: 917102
max: 28932135
comments:
all: 1347858
avg: 74881
median: 39263
min: 9530
max: 403551
engagement:
avgEngagementRate: 0.01
likesPerFollower: 0.0099
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0255
medianVsMean: 0.7149
topBottomRatio: 11.836
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 41178588
avg: 3743508
median: 1670761
min: 686785
max: 18153481
comments:
all: 1076878
avg: 97898
median: 18679
min: 9302
max: 626669
views:
all: 883750835
avg: 80340985
median: 46003268
min: 33974860
max: 247930800
engagement:
avgEngagementRate: 0.0362
likesPerFollower: 0.0056
commentsPerFollower: 0.0001
viewsPerFollower: 0.1199
engagementConsistency:
cv: 0.4451
medianVsMean: 0.9933
topBottomRatio: 2.6984
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1766638923420
totalFollowers: 669681145
totalFollowing: 623
totalContents: 3987
imagesPerformanceRecent:
likes:
all: 126650220
avg: 6332511
median: 4726118
min: 865580
max: 28914769
comments:
all: 1436000
avg: 71800
median: 39306
min: 9222
max: 403375
engagement:
avgEngagementRate: 0.0096
likesPerFollower: 0.0095
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0085
medianVsMean: 0.743
topBottomRatio: 12.5075
consistencyScore: 36
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 41685516
avg: 3473793
median: 1544745
min: 648914
max: 18012449
comments:
all: 1083984
avg: 90332
median: 16925
min: 8763
max: 622993
views:
all: 911473272
avg: 75956106
median: 45154857
min: 33205644
max: 246259392
engagement:
avgEngagementRate: 0.0351
likesPerFollower: 0.0052
commentsPerFollower: 0.0001
viewsPerFollower: 0.1134
engagementConsistency:
cv: 0.4504
medianVsMean: 0.9829
topBottomRatio: 2.7633
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1766466123420
totalFollowers: 669523275
totalFollowing: 623
totalContents: 3987
imagesPerformanceRecent:
likes:
all: 105739020
avg: 5874390
median: 4717582
min: 840632
max: 28905751
comments:
all: 1090548
avg: 60586
median: 38589
min: 9047
max: 403385
engagement:
avgEngagementRate: 0.0089
likesPerFollower: 0.0088
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0341
medianVsMean: 0.8003
topBottomRatio: 10.1108
consistencyScore: 34
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 41517552
avg: 3459796
median: 1540905
min: 637472
max: 17937850
comments:
all: 1081824
avg: 90152
median: 16832
min: 8416
max: 621742
views:
all: 907247544
avg: 75603962
median: 45093106
min: 32941934
max: 245404499
engagement:
avgEngagementRate: 0.0351
likesPerFollower: 0.0052
commentsPerFollower: 0.0001
viewsPerFollower: 0.1129
engagementConsistency:
cv: 0.4516
medianVsMean: 0.9823
topBottomRatio: 2.7794
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1766379723420
totalFollowers: 669404801
totalFollowing: 623
totalContents: 3986
imagesPerformanceRecent:
likes:
all: 99297595
avg: 5841035
median: 4613392
min: 820734
max: 28897754
comments:
all: 1042406
avg: 61318
median: 37217
min: 8836
max: 403319
engagement:
avgEngagementRate: 0.0088
likesPerFollower: 0.0087
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0719
medianVsMean: 0.7877
topBottomRatio: 10.1687
consistencyScore: 33
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 41391504
avg: 3449292
median: 1537825
min: 625656
max: 17887234
comments:
all: 1080768
avg: 90064
median: 16743
min: 8265
max: 621208
views:
all: 904338336
avg: 75361528
median: 45045084
min: 32637457
max: 244844289
engagement:
avgEngagementRate: 0.0351
likesPerFollower: 0.0052
commentsPerFollower: 0.0001
viewsPerFollower: 0.1126
engagementConsistency:
cv: 0.4531
medianVsMean: 0.9823
topBottomRatio: 2.7971
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1766293323420
totalFollowers: 669232649
totalFollowing: 623
totalContents: 3986
imagesPerformanceRecent:
likes:
all: 93604016
avg: 5850251
median: 4519730
min: 789512
max: 28883343
comments:
all: 1004544
avg: 62784
median: 38504
min: 8679
max: 403179
engagement:
avgEngagementRate: 0.0088
likesPerFollower: 0.0087
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.1048
medianVsMean: 0.7706
topBottomRatio: 10.2599
consistencyScore: 33
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 41205276
avg: 3433773
median: 1533669
min: 604825
max: 17815656
comments:
all: 1079196
avg: 89933
median: 16665
min: 8076
max: 620152
views:
all: 900091920
avg: 75007660
median: 44974414
min: 31998758
max: 244041686
engagement:
avgEngagementRate: 0.035
likesPerFollower: 0.0051
commentsPerFollower: 0.0001
viewsPerFollower: 0.1121
engagementConsistency:
cv: 0.4556
medianVsMean: 0.9829
topBottomRatio: 2.8264
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1766206923420
totalFollowers: 669232649
totalFollowing: 623
totalContents: 3986
imagesPerformanceRecent:
likes:
all: 97416647
avg: 5730391
median: 4416254
min: 735186
max: 28849862
comments:
all: 1053337
avg: 61961
median: 39799
min: 8419
max: 402918
engagement:
avgEngagementRate: 0.0087
likesPerFollower: 0.0086
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0936
medianVsMean: 0.7688
topBottomRatio: 10.4202
consistencyScore: 33
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 41125992
avg: 3427166
median: 1531659
min: 594221
max: 17792818
comments:
all: 1078692
avg: 89891
median: 16636
min: 8018
max: 619844
views:
all: 898372392
avg: 74864366
median: 44944272
min: 31740378
max: 243777711
engagement:
avgEngagementRate: 0.035
likesPerFollower: 0.0051
commentsPerFollower: 0.0001
viewsPerFollower: 0.1119
engagementConsistency:
cv: 0.4573
medianVsMean: 0.9834
topBottomRatio: 2.845
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1766120523420
totalFollowers: 669122041
totalFollowing: 623
totalContents: 3985
imagesPerformanceRecent:
likes:
all: 97416647
avg: 5730391
median: 4416254
min: 735186
max: 28849862
comments:
all: 1053337
avg: 61961
median: 39799
min: 8419
max: 402918
engagement:
avgEngagementRate: 0.0087
likesPerFollower: 0.0086
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0936
medianVsMean: 0.7688
topBottomRatio: 10.4202
consistencyScore: 33
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 40877892
avg: 3406491
median: 1526515
min: 569654
max: 17688411
comments:
all: 1076280
avg: 89690
median: 16503
min: 7664
max: 618581
views:
all: 891978744
avg: 74331562
median: 44823800
min: 30811533
max: 242568633
engagement:
avgEngagementRate: 0.0349
likesPerFollower: 0.0051
commentsPerFollower: 0.0001
viewsPerFollower: 0.1111
engagementConsistency:
cv: 0.4593
medianVsMean: 0.9837
topBottomRatio: 2.8743
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1765947723420
totalFollowers: 669003324
totalFollowing: 623
totalContents: 3982
imagesPerformanceRecent:
likes:
all: 99487422
avg: 5527079
median: 4336795
min: 623264
max: 28751993
comments:
all: 1038366
avg: 57687
median: 36512
min: 7596
max: 402190
engagement:
avgEngagementRate: 0.0083
likesPerFollower: 0.0083
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.1025
medianVsMean: 0.7844
topBottomRatio: 10.7558
consistencyScore: 33
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 40271892
avg: 3355991
median: 1513436
min: 499394
max: 17463593
comments:
all: 1069992
avg: 89166
median: 16287
min: 6360
max: 615413
views:
all: 881244468
avg: 73437039
median: 44622694
min: 29071235
max: 240216682
engagement:
avgEngagementRate: 0.0345
likesPerFollower: 0.005
commentsPerFollower: 0.0001
viewsPerFollower: 0.1098
engagementConsistency:
cv: 0.4723
medianVsMean: 0.9905
topBottomRatio: 3.0294
consistencyScore: 53
consistencyLevel: moderate
- timestamp: 1765688523420
totalFollowers: 668945907
totalFollowing: 623
totalContents: 3982
imagesPerformanceRecent:
likes:
all: 98466584
avg: 5792152
median: 4367781
min: 974758
max: 28649924
comments:
all: 1028517
avg: 60501
median: 36952
min: 12155
max: 401632
engagement:
avgEngagementRate: 0.0087
likesPerFollower: 0.0087
commentsPerFollower: 0.0001
engagementConsistency:
cv: 1.0589
medianVsMean: 0.7529
topBottomRatio: 6.8049
consistencyScore: 35
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 39439125
avg: 3585375
median: 1630460
min: 467927
max: 17295265
comments:
all: 1060246
avg: 96386
median: 16885
min: 13180
max: 613313
views:
all: 839149091
avg: 76286281
median: 45353877
min: 27962153
max: 238459306
engagement:
avgEngagementRate: 0.0363
likesPerFollower: 0.0054
commentsPerFollower: 0.0001
viewsPerFollower: 0.114
engagementConsistency:
cv: 0.4368
medianVsMean: 1.0003
topBottomRatio: 2.5694
consistencyScore: 54
consistencyLevel: moderate
- timestamp: 1765515723420
totalFollowers: 668933651
totalFollowing: 623
totalContents: 3980
imagesPerformanceRecent:
likes:
all: 115448864
avg: 6076256
median: 4351354
min: 962732
max: 28538136
comments:
all: 1250485
avg: 65815
median: 39753
min: 12066
max: 400571
engagement:
avgEngagementRate: 0.0092
likesPerFollower: 0.0091
commentsPerFollower: 0.0001
engagementConsistency:
cv: 0.9627
medianVsMean: 0.7144
topBottomRatio: 7.3385
consistencyScore: 37
consistencyLevel: low
reelsPerformanceRecent:
likes:
all: 39011764
avg: 3546524
median: 1624284
min: 415644
max: 17055780
comments:
all: 1054801
avg: 95891
median: 16460
min: 12454
max: 610265
views:
all: 832031255
avg: 75639205
median: 45239070
min: 26499315
max: 235903716
engagement:
avgEngagementRate: 0.0361
likesPerFollower: 0.0053
commentsPerFollower: 0.0001
viewsPerFollower: 0.1131
engagementConsistency:
cv: 0.4418
medianVsMean: 1.0041
topBottomRatio: 2.6122
consistencyScore: 54
consistencyLevel: moderate
creditsUsed: 1
creditsAvailable: -1
traceId: ea11c06423616d5fe906cc77c5a9697f
timestamp: 1767934923526
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 pastDayRange:
summary: pastDayRange out of bounds
value:
success: false
error: VALIDATION_ERROR
message: '''pastDayRange'' out of range. Must be between 1 and 365.'
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 GET
"https://apiv3.creatordb.app/instagram/performance-history?uniqueId=cristiano&pastDayRange=30"
\
-H "Content-Type: application/json" \
-H "api-key: "
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````