> ## 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 Information > Retrieve advanced performance information of a specified Instagram creator, including post activity, follower growth, engagement metrics, and content performance.

Optionally pass `fields` in the request body to return only a subset of performance blocks. Requesting a subset bills fractionally, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). Per-field costs are not published yet. For how fractional costs work, see [Fractional Costs](/api-v3/fractional-calls). ## OpenAPI ````yaml /api-v3/api-v3.yaml post /instagram/performance 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: post: tags: - Instagram summary: Get Performance Information description: >- Retrieve advanced performance information of a specified Instagram creator, including post activity, follower growth, engagement metrics, and content performance.

Optionally pass `fields` in the request body to return only a subset of performance blocks. Requesting a subset bills fractionally, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). Per-field costs are not published yet. For how fractional costs work, see [Fractional Costs](/api-v3/fractional-calls). operationId: getInstagramPerformance 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 performance blocks to return. Omit or pass an empty array to return the full response at the full-bundle price. Per-field costs are not published yet. items: type: string responses: '200': description: Instagram performance data returned successfully. content: application/json: schema: type: object description: >- Performance data of the specified Instagram creator returned successfully. properties: data: type: object description: The Instagram performance data. properties: contentCountByDays: type: object description: >- Published Instagram posts over different time intervals. properties: 7d: type: integer description: Number of posts published in the past 7 days. minimum: 0 examples: - 4 30d: type: integer description: Number of posts published in the past 30 days. minimum: 0 examples: - 13 90d: type: integer description: Number of posts published in the past 90 days. minimum: 0 examples: - 45 required: - 7d - 30d - 90d ranking: type: object description: >- Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median. properties: totalFollowers: type: object description: Percentile rank of the total follower count. properties: global: type: number description: >- Percentile rank compared to all creators in CreatorDB's database. minimum: 0 maximum: 1 examples: - 0.9912 country: type: number description: >- Percentile rank among creators from the same country. minimum: 0 maximum: 1 examples: - 0.9986 language: type: number description: >- Percentile rank among creators using the same primary language. minimum: 0 maximum: 1 examples: - 0.9764 required: - global - country - language avgEngagementRate: type: object description: >- Percentile rank of the average engagement rate, calculated based on the creator's recent posts. properties: global: type: number description: >- Percentile rank compared to all creators in CreatorDB's database. minimum: 0 maximum: 1 examples: - 0.9912 country: type: number description: >- Percentile rank among creators from the same country. minimum: 0 maximum: 1 examples: - 0.9986 language: type: number description: >- Percentile rank among creators using the same primary language. minimum: 0 maximum: 1 examples: - 0.9764 required: - global - country - language required: - totalFollowers - avgEngagementRate imagesPerformanceRecent: type: object description: >- Performance metrics of the creator's recent Instagram image posts. 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 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: >- Performance metrics of the creator's recent Instagram reels. 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 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 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 of Instagram reels, including standard engagement metrics and views per follower. properties: avgEngagementRate: type: number description: >- Average engagement rate per 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. 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 recentImagesGrowth: type: object description: >- Growth metrics for recent Instagram image posts across 7, 30, and 90-day periods. properties: g7: type: object description: Growth metrics over 7 days. properties: engagementRate: type: number description: >- Growth rate of engagement rate, rounded to 4th decimal place. examples: - 0.0567 required: - engagementRate g30: type: object description: Growth metrics over 30 days. properties: engagementRate: type: number description: >- Growth rate of engagement rate, rounded to 4th decimal place. examples: - 0.0567 required: - engagementRate g90: type: object description: Growth metrics over 90 days. properties: engagementRate: type: number description: >- Growth rate of engagement rate, rounded to 4th decimal place. examples: - 0.0567 required: - engagementRate required: - g7 - g30 - g90 recentReelsGrowth: type: object description: >- Growth metrics for recent Instagram reels across 7, 30, and 90-day periods. properties: g7: type: object description: Growth metrics over 7 days. properties: avgViews: type: number description: >- Growth rate of average views, rounded to 4th decimal place. examples: - 0.2345 engagementRate: type: number description: >- Growth rate of engagement rate, rounded to 4th decimal place. examples: - 0.0567 required: - avgViews - engagementRate g30: type: object description: Growth metrics over 30 days. properties: avgViews: type: number description: >- Growth rate of average views, rounded to 4th decimal place. examples: - 0.2345 engagementRate: type: number description: >- Growth rate of engagement rate, rounded to 4th decimal place. examples: - 0.0567 required: - avgViews - engagementRate g90: type: object description: Growth metrics over 90 days. properties: avgViews: type: number description: >- Growth rate of average views, rounded to 4th decimal place. examples: - 0.2345 engagementRate: type: number description: >- Growth rate of engagement rate, rounded to 4th decimal place. examples: - 0.0567 required: - avgViews - engagementRate required: - g7 - g30 - g90 required: - contentCountByDays - ranking - imagesPerformanceRecent - reelsPerformanceRecent - recentImagesGrowth - recentReelsGrowth 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: contentCountByDays: 7d: 2 30d: 17 90d: 50 ranking: totalFollowers: global: 1 country: 1 language: 1 avgEngagementRate: global: 0.3151 country: 0.2419 language: 0.2027 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 creditsUsed: 1 creditsAvailable: -1 traceId: 4dc65ca4b026cc141bbd44adda8f0c55 timestamp: 1767933681199 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 ID must be between 1 and 31 characters. timestamp: 1770099403116 '429': description: Exceeded quota or rate limit. content: application/json: schema: type: object title: QuotaErrorResponse description: Quota error response format. 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/performance" \ -H "Content-Type: application/json" \ -H "api-key: " \ -d '{ "uniqueId": "cristiano" }' components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````