> ## 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 basic Instagram metrics > Get the basic metrics data of a creator's Instagram account. ## OpenAPI ````yaml /api-v2/api-v2.yaml get /instagramBasic openapi: 3.1.0 info: version: '2' title: CreatorDB Headless APIService description: >- Generated from swaggerComponentIndex.json by core-types-json-schema (https://github.com/grantila/core-types-json-schema). Use OpenAPI 3.1.0 version with direct JSON Schema support termsOfService: https://www.creatordb.app 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 x-id: indexForSwagger.yaml servers: - url: https://dev.creatordb.app/v2 description: CreatorDB API Endpoint - prod version security: [] tags: - name: General Operations description: >- General-purpose endpoints such as API status, content retrieval, and cross-platform operations - name: YouTube description: >- YouTube creator data endpoints including basic metrics, historical data, and detailed analytics - name: Instagram description: >- Instagram creator data endpoints with metrics and advanced search capabilities - name: TikTok description: >- TikTok creator data endpoints with metrics and advanced search functionality - name: Threads description: Threads creator data endpoints with basic metrics and historical data - name: Facebook description: Facebook creator data endpoints with metrics and search capabilities - name: Topic description: Topic-based analysis and reporting endpoints for content categorization - name: Brand description: Brand analysis endpoints including sponsor search and brand reports - name: Niches description: Niche-related endpoints for content category analysis and related searches paths: /instagramBasic: get: tags: - Instagram summary: Get basic Instagram metrics description: Get the basic metrics data of a creator's Instagram account. operationId: getInstagramBasic parameters: - name: apiId in: header description: '' required: true schema: type: string examples: - LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W - name: instagramId in: query description: '' required: true schema: type: string examples: - goodalicia responses: '200': description: OK content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/BasicInstagramResult' quotaUsed: type: number description: API credits that were used to make this call. quotaUsedTotal: type: number description: Total API credits used since the last billing cycle. remainingPlanCredit: type: number description: >- The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle. remainingPrepurchasedCredit: type: number description: >- The number of remaining extra purchased API credits. These API credits do not expire until used. timestamp: type: number description: >- Unix timestamp of the call request that the server received. error: type: string description: Errors that occurred during the API call. success: type: boolean description: It is TRUE when the call is successful. examples: default: value: data: basicInstagram: instagramId: goodalicia instagramName: 愛莉莎莎 Alisasa 🐨 youtubeId: UCAKJ0tmI_RMXqTgxL_OMfIg avatar: >- https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-19/500169417_18514151086053040_2166230648120544979_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2QHkDpA5LAWIIMpSET0iCG2Co0q8yoEHEmXha0RA5vXAuOngHJFnSB3BXmunKAuVxvE&_nc_ohc=qQjuRTsD1gEQ7kNvwFmf6MV&_nc_gid=yhB1kV-Ksvk0CzldHDx1HA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfXw_TDIQubUIjvPVnc4SeBiJOe5zGlESSQaRoHjnyfYzQ&oe=68A5A6E7&_nc_sid=10d13b description: |- 120萬訂閱YouTuber 佛系經營中 合作信箱alisasaofficial@gmail.com category: Art categoryBusiness: None isVerified: true isBusinessAccount: false isPrivateAccount: false hashtags: - '#doubleblackcrew' - '#dbc滑雪' - '#遲來的母親節文' nicheIds: - id_india_All - id_newyear_All - id_thailand_All following: 1204 followers: 613344 posts: 1609 engageRate: 0.01800025760421558 avgLikes: 13884.655172413793 avgComments: 89.51724137931035 avgPostsPerDay: 0.1491134349230791 activeUserType: WAU relatedUsers: - animalkaisha - peiweini - yuxuannh recentPosts: - shortcode: DMZ_s_Xy-Er isVideo: true videoViews: 0 isReels: true title: |- 省電費內衣👍🏻 目前七天賣了3200萬🥳 photoURL: >- https://www.instagram.com/p/DMZ_s_Xy-Er/media/?size=l carouselUrls: - >- https://www.instagram.com/p/DMZ_s_Xy-Er/media/?size=l likes: 5218 comments: 46 engageRate: 0.008582459435488079 updateDate: 1753179002000 hashtags: [] photoContains: [] taggedUsers: [] location: '' - shortcode: DMRw6T2St3u isVideo: true videoViews: 0 isReels: true title: |- 史上最優惠：買一件內衣 就送一件面膜內褲🎉 這次也三天就賣了1400萬 好猛👍🏻 photoURL: >- https://www.instagram.com/p/DMRw6T2St3u/media/?size=l carouselUrls: - >- https://www.instagram.com/p/DMRw6T2St3u/media/?size=l likes: 12992 comments: 114 engageRate: 0.021368106641623624 updateDate: 1752902842000 hashtags: [] photoContains: [] taggedUsers: [] location: '' - shortcode: DMCkc5CyZdf isVideo: false videoViews: 0 isReels: false title: |- 突然覺得這輩子一定要好好賺錢 以後都搭商務艙😭😭😭 這趟去美國 來回都搭星宇經濟艙 每趟都遇到籤王 去程隔壁坐一個全身臭味超重的女人 把個人物品一直往我的位置壓縮 臭味也一直往我這邊飄 然後還突然開始被附身 對著螢幕狂飆罵越南文（？） 第一次遇到瘋子在身邊 空姐幫我換位子之後 熄燈時 我把椅背往後倒 還被後面人阻止說不要倒下來😂 第一次 我想說忍耐到她睡著我再倒 結果她睡著後仍然管我 我倒下去他就用手推回來 我跟她說現在不是吃飯時間 是熄燈睡覺時間 這個椅子本來就是設計倒下來的 沒想到累到像狗 也要跟人先吵一架才能睡覺🥲 回程背後的人又是一個沒品大叔 他已經很幸運坐到 一整排只有他一個人的位置 還要把臭腳往前放到我的座位扶手上 還一直踢+大聲講電話 乾 不知道是不是宇宙在催促我好好賺錢 去坐商務艙 不要再到經濟艙碰運氣了😅 photoURL: >- https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l carouselUrls: - >- https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-15/518483399_18524696089053040_8623387199947956577_n.jpg?stp=dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjE0NDB4MTkyMC5zZHIuZjgyNzg3LmRlZmF1bHRfaW1hZ2UuYzIifQ&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2QEGr0WvXQHjut_bpY_tjknzBbXhk2y8g9zIA2C90xvg8j7I1lpQTs2RBVmso1p782oBb7mzgGGqtRQycR7A7mMC&_nc_ohc=uNoN6ENi854Q7kNvwHwp_8l&_nc_gid=DXa_0OtJVZXGLT3MXfSF4w&edm=AP4sbd4BAAAA&ccb=7-5&ig_cache_key=MzY3NTY2MDU0ODAzMDc5OTgxNQ%3D%3D.3-ccb7-5&oh=00_AfWWYM5h2K19r_iwlRozgTuoFX-4EeC0C2KYO89nGfDr0Q&oe=68A5CBD8&_nc_sid=7a9f4b - >- https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-15/517945364_18524696098053040_6513109263875463087_n.jpg?stp=dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjE0NDB4MTkyMC5zZHIuZjgyNzg3LmRlZmF1bHRfaW1hZ2UuYzIifQ&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2QEGr0WvXQHjut_bpY_tjknzBbXhk2y8g9zIA2C90xvg8j7I1lpQTs2RBVmso1p782oBb7mzgGGqtRQycR7A7mMC&_nc_ohc=Jz91ya0F7cAQ7kNvwHetudj&_nc_gid=DXa_0OtJVZXGLT3MXfSF4w&edm=AP4sbd4BAAAA&ccb=7-5&ig_cache_key=MzY3NTY2MDU0ODAzOTIxMzU5NA%3D%3D.3-ccb7-5&oh=00_AfVXb7ynBLpxpkgJSttlXayzrYNzuGSGaVGgmrxSLOSOYg&oe=68A5C0D9&_nc_sid=7a9f4b - >- https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-15/520507949_18524696155053040_9088014485332567238_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0uaW1hZ2VfdXJsZ2VuLjcyMHg5NjAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2NvdmVyX2ZyYW1lLmMyIn0&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2QEGr0WvXQHjut_bpY_tjknzBbXhk2y8g9zIA2C90xvg8j7I1lpQTs2RBVmso1p782oBb7mzgGGqtRQycR7A7mMC&_nc_ohc=Bw-L0QkZqSkQ7kNvwGU3V6K&_nc_gid=DXa_0OtJVZXGLT3MXfSF4w&edm=AP4sbd4BAAAA&ccb=7-5&ig_cache_key=MzY3NTY1OTgyMTkzNzkyMjgzNw%3D%3D.3-ccb7-5&oh=00_AfUbCCye8Lmfl_-8m24H65VD3Pwz-I6753SCErRNbqI54w&oe=68A5A507&_nc_sid=7a9f4b likes: 15840 comments: 121 engageRate: 0.026022916992747953 updateDate: 1752392905000 hashtags: [] photoContains: [] taggedUsers: [] location: '' recentReels: - views: 0 plays: 398566 length: 53.758 promptStickerId: '' promptStickerLabel: '' filterId: '' filterLabel: '' musicId: '' musicTitle: '' musicDisplayArtist: '' shortcode: DMZ_s_Xy-Er title: |- 省電費內衣👍🏻 目前七天賣了3200萬🥳 comments: 46 likes: 5218 engageRate: 0.013207348343812568 updateDate: 1753179002000 hashtags: [] taggedUsers: [] location: '' - views: 0 plays: 2573243 length: 47.2 promptStickerId: '' promptStickerLabel: '' filterId: '' filterLabel: '' musicId: '' musicTitle: '' musicDisplayArtist: '' shortcode: DMRw6T2St3u title: |- 史上最優惠：買一件內衣 就送一件面膜內褲🎉 這次也三天就賣了1400萬 好猛👍🏻 comments: 114 likes: 12992 engageRate: 0.005093183970577206 updateDate: 1752902842000 hashtags: [] taggedUsers: [] location: '' - views: 0 plays: 552839 length: 38.799 promptStickerId: '' promptStickerLabel: '' filterId: '' filterLabel: '' musicId: '' musicTitle: '' musicDisplayArtist: '' shortcode: DLMulkmSt0i title: |- 你們知道從0到學會滑雪要多久嗎⛷️ 從站都站不起來到現在可以Ｓ turn 我只花了六天 就直接成為雪道猴子🐒 我每年都是跟 @dbc.taiwan 的滑雪團 專業又帥的教練Ｘ五天四夜滑雪觀光行程 （還有包含東京或金澤一天自由行） 有料👍🏻 - 📌純課程目前也有開放湯澤！ 📌越早報名越優惠！行程名額有限，售完不加開 🌠行程包含 ．日航、星宇、長榮航空 或其他同級航空 ．五天四夜住宿 (包含一天自由行住宿) 及早餐 ．滑雪基本裝備 (含雪板、雪鞋、雪鏡、安全帽) ．兩日專業滑雪教練課及全天雪場雪票 ．機場-雪場專車接駁 (贈!!!新幹線一趟) ·參加DBC行程後並填寫回饋，更有機會獲得免費雙人5天4夜滑雪行程 #DoubleBlackCrew #DBC滑雪 comments: 78 likes: 12205 engageRate: 0.022218041780699263 updateDate: 1750586400000 hashtags: - '#DoubleBlackCrew' - '#DBC滑雪' taggedUsers: - dbc.taiwan location: '' country: TWN lang: zht tiktokId: '' lastPublishTime: 1753179002000 dbUpdateTime: 1755309755899 gRateFollowers: 0.011683086987287653 gRateLikes: 0.051414620134999284 gRateComments: -0.050128064398097326 gRateAvgLikes: 0.05141462013499937 gRateAvgComments: -0.05012806439809727 gRateEngageRate: -0.06678289560370977 isBD: false isBDDAU: true bdDauCheckedTimestamps: - 1751820467824 - 1752079503707 - 1752180276609 bdCountryCode: TWN bdActiveUserType: DAU bdIsPrivate: false quotaUsed: 2 quotaUsedTotal: 6026 remainingPlanCredit: 993974 remainingPrepurchasedCredit: 0 timestamp: 1755503515600 error: '' success: true '403': description: Forbidden content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/BasicInstagramResult' quotaUsed: type: number description: API credits that were used to make this call. quotaUsedTotal: type: number description: Total API credits used since the last billing cycle. remainingPlanCredit: type: number description: >- The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle. remainingPrepurchasedCredit: type: number description: >- The number of remaining extra purchased API credits. These API credits do not expire until used. timestamp: type: number description: >- Unix timestamp of the call request that the server received. error: type: string description: Errors that occurred during the API call. success: type: boolean description: It is TRUE when the call is successful. examples: default: value: data: null quotaUsed: 0 quotaUsedTotal: 0 remainingPlanCredit: 0 remainingPrepurchasedCredit: 0 timestamp: 1755503514834 error: APIKeyOnlyForTesting success: false servers: - url: https://dev.creatordb.app/v2 description: CreatorDB API Endpoint - prod version x-codeSamples: - lang: bash label: cURL source: | curl --request GET \ --url 'https://dev.creatordb.app/v2/instagramBasic?instagramId=goodalicia' \ --header 'Accept: application/json' \ --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' components: schemas: BasicInstagramResult: type: object additionalProperties: false properties: basicInstagram: $ref: '#/components/schemas/BasicInstagram' required: - basicInstagram BasicInstagram: type: object additionalProperties: false properties: instagramId: type: string description: Instagram account ID usually follows an \"@\" symbol. instagramName: type: string description: Creator's editable Instagram display name. youtubeId: type: string description: YouTube channel ID of the creator. avatar: type: string description: URL to the creator's Instagram profile picture. description: type: string description: >- Creator's biography that appears on their Instagram account's main page. category: type: string description: >- A user-selected description of the content on their page from Instagram preset available categories. categoryBusiness: type: string description: >- A user-selected description for Business Accounts to describe who or what the page represents. lang: type: string description: The language that this Instagram creator uses. isVerified: type: boolean description: It is TRUE when the creator's Instagram account is verified. isBusinessAccount: type: boolean description: >- It is TRUE when the creator's account is an Instagram professional account. isPrivateAccount: type: boolean description: Is TRUE when the Instagram account is private. hashtags: type: array description: The latest hashtags used by the creator in an Instagram post. items: type: string nicheIds: type: array description: The niche IDs of this Instagram account. items: type: string following: type: number description: >- The number of other Instagram accounts that the creator is following. followers: type: number description: The number of followers for this Instagram account. posts: type: number description: Total number of posts currently on this Instagram creator's page. engageRate: type: number description: >- Percentage that represents audience engagement with this creator's Instagram account. The engagement rate is calculated by adding likes and comments and then dividing by followers of the account. avgLikes: type: number description: Average likes per Instagram post from the latest 24 posts. avgComments: type: number description: Average comments per Instagram post from the latest 24 posts. avgPostsPerDay: type: number description: Average Instagram posts per day. activeUserType: $ref: '#/components/schemas/ActiveUserType' description: >- Metrics for unique users who interact with this creator's Instagram account are retrieved as follows: Daily Active Users (DAU), Weekly Active Users (WAU), Monthly Active Users (MAU), and Yearly Active Users (YAU). relatedUsers: type: array description: Instagram recommended users based on its algorithm. items: type: string recentPosts: type: array description: The latest 24 Instagram posts uploaded by the creator. items: $ref: '#/components/schemas/InstagramPostInfo' recentReels: type: array description: Recent reels by this Instagram creator. items: $ref: '#/components/schemas/InstagramReelInfo' country: type: string description: CreatorDB calculated the Instagram creator's country of origin. tiktokId: type: string description: >- User ID of the creator's TikTok page if they have one. Otherwise, this field will be blank. lastPublishTime: type: number description: >- Unix timestamp of the last content upload time to the Instagram creator's account. dbUpdateTime: type: number description: >- Unix timestamp of the last update time of the Instagram creator's data. gRateFollowers: type: number description: >- The month-on-month growth rate of Instagram followers from the last 30 days. gRateLikes: type: number description: >- The month-on-month growth rate of total likes is based on the last 24 Instagram posts from the last 30 days. gRateComments: type: number description: >- The month-on-month growth rate of the total comments from most recent posts. gRateAvgLikes: type: number description: >- The month-on-month growth rate of the average likes from Instagram posts over the last 30 days. gRateAvgComments: type: number description: >- The month-on-month growth rate of the average comments of Instagram posts from the last 30 days. gRateEngageRate: type: number description: >- The month-on-month growth rate of the average engagement rate of Instagram posts from the last 30 days. isBD: type: boolean isBDDAU: type: boolean bdDauCheckedTimestamps: type: array items: type: number bdCountryCode: type: string bdActiveUserType: $ref: '#/components/schemas/ActiveUserType' bdIsPrivate: type: boolean required: - instagramId - instagramName - youtubeId - avatar - description - category - categoryBusiness - lang - isVerified - isBusinessAccount - isPrivateAccount - hashtags - nicheIds - following - followers - posts - engageRate - avgLikes - avgComments - avgPostsPerDay - activeUserType - relatedUsers - recentPosts - recentReels - country - tiktokId - lastPublishTime - dbUpdateTime - gRateFollowers - gRateLikes - gRateComments - gRateAvgLikes - gRateAvgComments - gRateEngageRate - isBD - isBDDAU - bdDauCheckedTimestamps - bdCountryCode - bdActiveUserType - bdIsPrivate ActiveUserType: type: string enum: - DAU - WAU - MAU - YAU description: >- Active user data types include Daily Active Users (DAU), Weekly Active Users (WAU), Monthly Active Users (MAU), and Yearly Active Users (YAU). InstagramPostInfo: type: object additionalProperties: false properties: shortcode: type: string description: A shortened unique ID of the post. isVideo: type: boolean description: It is TRUE when the Instagram post is a video. videoViews: type: number description: The number of plays of an Instagram reel. isReels: type: boolean description: It is TRUE when the Instagram post is a reel. title: type: string description: The creator's written caption for the Instagram post. photoURL: type: string description: URL of the post. carouselUrls: type: array description: URLs of the images used in the Instagram carousel post. items: type: string likes: type: number description: The number of likes the Instagram post received. comments: type: number description: The number of comments the Instagram post received. engageRate: type: number description: >- The percentage that represents audience engagement with this Instagram post. The engagement rate is calculated by adding likes and comments and dividing by account followers. updateDate: type: number description: Unix timestamp of the Instagram post upload time. hashtags: type: array description: Hashtags that are included in the Instagram post. items: type: string photoContains: type: array description: >- An automatically generated description by analyzing the post content. items: type: string taggedUsers: type: array description: IDs of other Instagram users tagged in the post. items: type: string location: type: string description: City, state, or province labeled in the Instagram post. required: - shortcode - isVideo - videoViews - isReels - title - photoURL - carouselUrls - likes - comments - engageRate - updateDate - hashtags - photoContains - taggedUsers - location InstagramReelInfo: type: object additionalProperties: false properties: views: type: number description: Total views of the Instagram reels. plays: type: number description: Total plays of the Instagram reels. length: type: number description: An Instagram reel's length in seconds. promptStickerId: type: string description: Unique ID of the interactive \"Add Yours\" sticker feature. promptStickerLabel: type: string description: The text prompt displayed in the \"Add Yours\" sticker feature. filterId: type: string filterLabel: type: string musicId: type: string description: Unique ID to identify the song track used in an Instagram reel. musicTitle: type: string description: Title of the song track used in the Instagram reel. musicDisplayArtist: type: string description: >- The name of the artist as displayed in the music feature on Instagram. shortcode: type: string description: Shortened unique IDs of the Instagram reels. title: type: string description: Written captions of the Instagram reel. comments: type: number description: Total comments on these Instagram reels. likes: type: number description: Total likes Instagram reels received. engageRate: type: number description: >- The audience engagement rate for these Instagram reels is calculated by adding likes and comments and dividing them by the creator's Instagram followers. updateDate: type: number description: Unix timestamp of the upload time of the Instagram reel. hashtags: type: array description: Hashtags that are included in the Instagram reels. items: type: string taggedUsers: type: array description: IDs of other Instagram users tagged in the reel. items: type: string location: type: string description: City, state, or province labeled in the Instagram reel. required: - views - plays - length - promptStickerId - promptStickerLabel - filterId - filterLabel - musicId - musicTitle - musicDisplayArtist - shortcode - title - comments - likes - engageRate - updateDate - hashtags - taggedUsers - location ````