> ## 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 Facebook historical data > Get the basic metrics and historical data of a creator's Facebook account. ## OpenAPI ````yaml /api-v2/api-v2.yaml get /facebookHistory 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: /facebookHistory: get: tags: - Facebook summary: Get Facebook historical data description: >- Get the basic metrics and historical data of a creator's Facebook account. operationId: getFacebookHistory parameters: - name: apiId in: header description: '' required: true schema: type: string examples: - LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W - name: facebookId in: query description: '' required: true schema: type: string examples: - facebook responses: '200': description: OK content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/BasicFacebookAndHistoryResult' 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: basicFacebook: facebookId: facebook facebookUserId: '100064860875397' facebookPageId: '' facebookName: Facebook avatar: >- https://scontent.ftpe7-4.fna.fbcdn.net/v/t39.30808-1/380700650_10162533193146729_2379134611963304810_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=101&ccb=1-7&_nc_sid=f907e8&_nc_ohc=Pmr2kK1tyAUQ7kNvwHvwwDU&_nc_oc=AdnQpbv-IV21PFqewRRTHKr4fyUODt8e0AfS4JLFrJn_M_6xTxIk15tuxADgGAtDcZY&_nc_zt=24&_nc_ht=scontent.ftpe7-4.fna&_nc_gid=583U506OEq5dO2HJr2DA6A&oh=00_AfX61rg0MpK7SFzYIWek6eX75xXwqQPJ_njfO8UK1avdqA&oe=68A52C0E cover: >- https://scontent.ftpe7-3.fna.fbcdn.net/v/t39.30808-6/513094825_10164819146606729_8444440187994304660_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=1&ccb=1-7&_nc_sid=cc71e4&_nc_ohc=DhBJbGOVMAUQ7kNvwG29gl-&_nc_oc=AdmrfSq7eedKpVS_DcHsozTjJQ36Q1Ho8h4yjlVHCk7VJD_qn_Fay7Y-QKF4Yg1mDVI&_nc_zt=23&_nc_ht=scontent.ftpe7-3.fna&_nc_gid=583U506OEq5dO2HJr2DA6A&oh=00_AfUqdDAFaQ-DeOlE08efvF2ZJhOjcbUsnUjzfeYyeq8qAg&oe=68A531BD isVerified: false category: Page · Internet company description: >- Community Values We believe people can do more together than alone and that each of us plays an important role in helping to create a safe and respectful community. So, we’ve laid out a set of principles for us to follow on this Page: Let’s celebrate the things that bring us together. Let’s choose to treat each other like neighbors rather than strangers. Let’s respect individuality and welcome diverse backgrounds and perspectives. Let’s assume people mean well. Our moderators are here for the community to uphold these values every day. links: - title: http://fb.me/HowToContactFB url: >- https://l.facebook.com/l.php?u=https%3A%2F%2Ffb.me%2FHowToContactFB&h=AT3VjDykVzW5ea8ScshoHxRtFeZCc9CwdqLs7RJFke3vo2b_4UFdtfOcXj2KYuK36al171SOLNXd-GtOb3i0c2iHahJ8kKnaw2e7SVzD-G3coZMVVYsRBmNtnafV9yaslX5F5TR-RXECdujT&s=1 joinedDate: 0 hasEmail: false emails: [] hashtags: - '#WorldPoetryDay' - '#MarchMadness' - '#Piday' likes: 151000000 followers: 155000000 following: 0 posts: 20 reels: 10 avgReactions: 18742.05 avgComments: 4101.75 avgShares: 873.65 avgPlays: 0 avgReactionsReels: 0 avgCommentsReels: 0 avgSharesReels: 0 avgPlaysReels: 9010000 lastUploadTime: 1755189111000 dbUpdateTime: 1755268233768 gRateAvgReactions: -0.08505251052981601 gRateAvgComments: -0.08505251052981601 gRateAvgShares: 0.27923753992423683 gRateAvgPlays: 0 gRateAvgReactionsReels: 0 gRateAvgCommentsReels: 0 gRateAvgSharesReels: 0 gRateAvgPlaysReels: 0.011587078651685394 gRateLikes: 0 gRateFollowers: 0 gRateFollowing: 0 gRatePosts: 0 gRateReels: 0 recentPosts: - id: '24302989706022765' url: https://www.facebook.com/events/24302989706022765/ title: '' photoUrls: [] videoUrls: [] linkUrls: [] reactions: 3316 shares: 0 comments: 1490 engageRate: 0 uploadDate: 1755189111000 hashtags: [] - id: '1252215886950429' url: >- https://www.facebook.com/facebook/posts/pfbid025XHEyMbBFqEo67jZ6o8MR7mGR6WXJdwHwBatMnfB4LS9BUJXwK2dkZsu4AGpQuk5l title: >- This is how taking a perfect selfie for your profile pic is going to feel: 🌞︎💛︎ photoUrls: - >- https://www.facebook.com/photo.php?fbid=1252207493617935&set=a.736550611850295&type=3 videoUrls: [] linkUrls: [] reactions: 27317 shares: 655 comments: 9783 engageRate: 0 uploadDate: 1755187188000 hashtags: [] - id: '1251390227032995' url: >- https://www.facebook.com/facebook/posts/pfbid029DzFZoQ6RyZ9i2qyjMu4JnELjoX9DCgp1BHNS51PDGFPkhLD8a1xadrYufvAPEZBl title: >- “Yeah, I’m a documentarian” = “Yeah, I post to Stories at least 20 times a day” photoUrls: [] videoUrls: [] linkUrls: [] reactions: 37125 shares: 1690 comments: 7767 engageRate: 0 uploadDate: 1755111600000 hashtags: [] recentReels: - id: '1194576502714368' url: https://www.facebook.com/reel/3894716004079577 title: >- Facebook creator Jhamil Bader's photography and videography is a breath of fresh air. 🍃🍄💧 “Creating on Facebook has connected me with fellow artists and an audience that both inspire my creativity and shape the way I approach sharing immersive outdoors experiences through my work.” Music by: Hiraeth and Énouement videoThumbnail: >- https://scontent.ftpe7-3.fna.fbcdn.net/v/t15.5256-10/506813650_1729338074642010_3221893611037423172_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=108&ccb=1-7&_nc_sid=73dd82&_nc_ohc=x2mr7MAKpi8Q7kNvwGdQhTu&_nc_oc=AdkCyF1rqUWgT58McOkblEhtErEPQOG_z35A-fBfP2HILuy4oYuA_--KDsK6LoLGddQ&_nc_zt=23&_nc_ht=scontent.ftpe7-3.fna&_nc_gid=_pS8qqrkDWkFCN8JVChjfQ&oh=00_AfXBZs90U_o3dhKa6m-sEcsbB3YvWRTxew5Pev7ozQRKLg&oe=68A4FE9C videoUrl: https://www.facebook.com/reel/3894716004079577/ videoWidth: 1080 videoHeight: 1920 videoLength: 13.312 isBroadcast: false isStreaming: false isPodcast: false isGamingVideo: false audioTrackType: LIBRARY_MUSIC audioTrackTitle: hiræth · hummingbird plays: 2800000 engageRate: 0 uploadDate: 1749754548 hashtags: [] - id: '1192791966226155' url: https://www.facebook.com/reel/717184740710964 title: >- Folding laundry but make it ✨art✨ Artist and Facebook creator Eliza Reinhardt Studio makes fabric portraits of artists’ work to share their stories — and make fine art more approachable. 🎨 Music by Billie Eilish videoThumbnail: >- https://scontent.ftpe7-2.fna.fbcdn.net/v/t15.5256-10/506183003_675149038727688_9211370703458759942_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=111&ccb=1-7&_nc_sid=73dd82&_nc_ohc=vsMt3uW7jdQQ7kNvwFYQcmL&_nc_oc=AdlRa6fXKVIeUG9EkKZ5p_RKZhWfVLf3UT4EEvoFz0uuK9nZt5-UReWG0j-6rBZc6cw&_nc_zt=23&_nc_ht=scontent.ftpe7-2.fna&_nc_gid=_pS8qqrkDWkFCN8JVChjfQ&oh=00_AfVbWoxQsaG7I27H6MmbbgpfSfqJCuW3q8KfAmUs7KQPnA&oe=68A50DCA videoUrl: https://www.facebook.com/reel/717184740710964/ videoWidth: 1080 videoHeight: 1920 videoLength: 16.81 isBroadcast: false isStreaming: false isPodcast: false isGamingVideo: false audioTrackType: LIBRARY_MUSIC audioTrackTitle: Penelope Speed · CHIHIRO (Instrumental) plays: 10000000 engageRate: 0 uploadDate: 1749581877 hashtags: [] - id: '1186663553505663' url: https://www.facebook.com/reel/2126382094504842 title: >- When you remember you have free will... 😂 Australia-based Facebook creator and comedian RoryEliza has a knack for putting a spin on everything — including getting the wrinkles out. 👕 videoThumbnail: >- https://scontent.ftpe7-1.fna.fbcdn.net/v/t15.5256-10/502245560_1774327586822979_4757132084885230830_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=110&ccb=1-7&_nc_sid=73dd82&_nc_ohc=uLdiIaZmwowQ7kNvwEOXnNU&_nc_oc=AdmIHgjdDy4HsguRSM5cIKtglFsk_EsslWDszDt58wIHaIpiNM_VTh45zCaxO5jFdGs&_nc_zt=23&_nc_ht=scontent.ftpe7-1.fna&_nc_gid=_pS8qqrkDWkFCN8JVChjfQ&oh=00_AfXGAta9rRfI6uTEVlx3StNwxxzKokMrg1Gh0_Q_1Lgisg&oe=68A515B5 videoUrl: https://www.facebook.com/reel/2126382094504842/ videoWidth: 1080 videoHeight: 1920 videoLength: 13.845 isBroadcast: false isStreaming: false isPodcast: false isGamingVideo: false audioTrackType: LIBRARY_MUSIC audioTrackTitle: No Doubt · Just A Girl plays: 11000000 engageRate: 0 uploadDate: 1748977300 hashtags: [] histories: - timestamp: 1755187200000 likes: 151000000 followers: 155000000 following: 0 posts: 20 reels: 10 avgReactions: 18742.05 avgComments: 4101.75 avgShares: 873.65 avgPlays: 0 avgReactionsReels: 0 avgCommentsReels: 0 avgSharesReels: 0 avgPlaysReels: 9010000 - timestamp: 1753804800000 likes: 151000000 followers: 155000000 following: 0 posts: 20 reels: 10 avgReactions: 24581.3 avgComments: 4924.6 avgShares: 956.55 avgPlays: 0 avgReactionsReels: 0 avgCommentsReels: 0 avgSharesReels: 0 avgPlaysReels: 9010000 - timestamp: 1752422400000 likes: 151000000 followers: 155000000 following: 0 posts: 20 reels: 10 avgReactions: 20837.75 avgComments: 4511 avgShares: 673.15 avgPlays: 0 avgReactionsReels: 0 avgCommentsReels: 0 avgSharesReels: 0 avgPlaysReels: 8900000 quotaUsed: 3 quotaUsedTotal: 6027 remainingPlanCredit: 993973 remainingPrepurchasedCredit: 0 timestamp: 1755503515499 error: '' success: true '403': description: Forbidden content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/BasicFacebookAndHistoryResult' 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: 1755503514812 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/facebookHistory?facebookId=facebook' \ --header 'Accept: application/json' \ --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' components: schemas: BasicFacebookAndHistoryResult: type: object additionalProperties: false properties: basicFacebook: $ref: '#/components/schemas/BasicFacebook' histories: type: array items: $ref: '#/components/schemas/FacebookHistoryDay' required: - basicFacebook - histories BasicFacebook: type: object additionalProperties: false properties: facebookId: type: string description: The Facebook account ID. facebookUserId: type: string description: Unique ID of the Facebook creator. facebookPageId: type: string description: Account ID of the Facebook fan page. facebookName: type: string description: The editable display name of the Facebook creator. avatar: type: string description: URL to the creator's Facebook profile picture. cover: type: string description: URL of the Facebook account's cover image. isVerified: type: boolean description: >- It is TRUE when the creator is verified by Facebook. It appears as a blue checkmark next to the creator's display name. category: type: string description: >- Category description that the creator selected for their Facebook fan page. description: type: string description: Description of the Facebook account. links: type: array items: type: object additionalProperties: false properties: title: type: string description: >- The name of a connected link to the About page of the Facebook account. url: type: string description: URL of the link on the Facebook account's About page. required: - title - url joinedDate: type: number description: The date that the Facebook account or page was created. hasEmail: type: boolean description: >- It is TRUE when CreatorDB's database has this creator's email contact. emails: type: array description: Email for this creator's Facebook account. items: type: string hashtags: type: array description: Total hashtags that are included in the Facebook video. items: type: string likes: type: number description: Total likes of this Facebook page. followers: type: number description: Total followers of this Facebook account. following: type: number description: Other Facebook pages that this account is following. posts: type: number description: Total posts of this Facebook page. reels: type: number description: Total reels of this Facebook page. avgReactions: type: number description: Average reactions per Facebook post. avgComments: type: number description: Average comments per Facebook post. avgShares: type: number description: Average shares per Facebook post. avgPlays: type: number description: Average views of a Facebook post avgReactionsReels: type: number description: Average reactions per Facebook reel. avgCommentsReels: type: number description: Average comments per Facebook reel. avgSharesReels: type: number description: Average shares per Facebook reel. avgPlaysReels: type: number description: Average plays or views of a Facebook reel. lastUploadTime: type: number description: Unix timestamp of the creator's last Facebook post upload time. dbUpdateTime: type: number description: Unix timestamp of the Facebook profile update time. gRateAvgReactions: type: number description: >- The growth rate of the average Facebook post reactions over the last 30 days. gRateAvgComments: type: number description: >- The growth rate of the average Facebook post comments over the last 30 days. gRateAvgShares: type: number description: >- The growth rate of the average Facebook post shares over the last 30 days. gRateAvgPlays: type: number description: >- The growth rate of the average video plays of Facebook posts over the last 30 days. gRateAvgReactionsReels: type: number description: >- The growth rate of the average Facebook reels reactions over the last 30 days. gRateAvgCommentsReels: type: number description: >- The growth rate of average Facebook reels comments over the last 30 days. gRateAvgSharesReels: type: number description: >- The growth rate of average Facebook reels shares over the last 30 days. gRateAvgPlaysReels: type: number description: >- The growth rate of average Facebook reels plays over the last 30 days, gRateLikes: type: number description: The growth rate of Facebook likes over the last 30 days. gRateFollowers: type: number description: The growth rate of Facebook followers over the last 30 days. gRateFollowing: type: number description: >- The growth rate of other Facebook pages that the creator has been following over the last 30 days. gRatePosts: type: number description: The growth rate of Facebook posts over the last 30 days. gRateReels: type: number description: The growth rate of Facebook reels over the last 30 days. recentPosts: type: array items: $ref: '#/components/schemas/FacebookPostInfo' recentReels: type: array items: $ref: '#/components/schemas/FacebookReelInfo' required: - facebookId - facebookUserId - facebookPageId - facebookName - avatar - cover - isVerified - category - description - links - joinedDate - hasEmail - emails - hashtags - likes - followers - following - posts - reels - avgReactions - avgComments - avgShares - avgPlays - avgReactionsReels - avgCommentsReels - avgSharesReels - avgPlaysReels - lastUploadTime - dbUpdateTime - gRateAvgReactions - gRateAvgComments - gRateAvgShares - gRateAvgPlays - gRateAvgReactionsReels - gRateAvgCommentsReels - gRateAvgSharesReels - gRateAvgPlaysReels - gRateLikes - gRateFollowers - gRateFollowing - gRatePosts - gRateReels - recentPosts - recentReels FacebookHistoryDay: type: object additionalProperties: false properties: timestamp: type: number description: Unix timestamp of the Facebook snapshot. likes: type: number description: Total likes of this Facebook page on the specified date in one year. followers: type: number description: >- Total followers of this Facebook page on the specified date in one year. following: type: number description: >- Other Facebook pages this creator is following on the specified date in one year. posts: type: number description: Total posts on this Facebook page on the specified date in one year. reels: type: number description: Total reels on this Facebook page on the specified date in one year. avgReactions: type: number description: >- Average reactions per Facebook post on the specified date in one year. avgComments: type: number description: >- Average comments per Facebook post on the specified date in one year. avgShares: type: number description: Average shares per Facebook post on the specified date in one year. avgPlays: type: number description: Average views per Facebook post on the specified date in one year. avgReactionsReels: type: number description: >- Average reactions per Facebook reel on the specified date in one year. avgCommentsReels: type: number description: >- Average comments per Facebook reel on the specified date in one year. avgSharesReels: type: number description: Average shares per Facebook reel on the specified date in one year. avgPlaysReels: type: number description: >- Average plays or views of the Facebook reel on the specified date in one year. required: - timestamp - likes - followers - following - posts - reels - avgReactions - avgComments - avgShares - avgPlays - avgReactionsReels - avgCommentsReels - avgSharesReels - avgPlaysReels FacebookPostInfo: type: object additionalProperties: false properties: id: type: string description: Unique ID of the Facebook post. url: type: string description: URL of the Facebook post. title: type: string description: Title of the Facebook post. photoUrls: type: array description: URLs of the photos in the Facebook post. items: type: string videoUrls: type: array description: URLs of the videos in the Facebook post. items: type: string linkUrls: type: array description: URLs of the articles in the Facebook post. items: type: string reactions: type: number description: The number of Facebook post reactions. shares: type: number description: The number of Facebook post shares. comments: type: number description: The number of Facebook post comments. engageRate: type: number description: >- The Facebook post's audience engagement rate. The engagement rate is calculated by adding the post's reactions and comments and dividing it by this creator's total Facebook followers. uploadDate: type: number description: Unix timestamp of the upload date of this Facebook post. hashtags: type: array description: Total hashtags included in this Facebook post. items: type: string required: - id - url - title - photoUrls - videoUrls - linkUrls - reactions - shares - comments - engageRate - uploadDate - hashtags FacebookReelInfo: type: object additionalProperties: false properties: id: type: string description: Unique ID of the Facebook reel. url: type: string description: URL of this Facebook reel. title: type: string description: Title of the Facebook reel. videoThumbnail: type: string description: URL to the small preview image of this Facebook reel. videoUrl: type: string description: URL of this Facebook video. videoWidth: type: number description: Width of the Facebook reel. videoHeight: type: number description: Height of the Facebook reel. videoLength: type: number description: Length of the Facebook reel in seconds. isBroadcast: type: boolean description: It is TRUE when the Facebook reel is being broadcasted. isStreaming: type: boolean description: It is TRUE when the Facebook reel is a live stream. isPodcast: type: boolean description: It is TRUE when the Facebook reel is a podcast. isGamingVideo: type: boolean description: It is TRUE when the Facebook reel is a gaming video. audioTrackType: type: string description: Audio track type of the Facebook reel. audioTrackTitle: type: string description: Audio track name or title of the Facebook reel. plays: type: number description: Total plays of the Facebook reel. engageRate: type: number description: >- The Facebook reel's engagement rate. This is calculated by adding reel reactions and comments and dividing by total plays. uploadDate: type: number description: Unix timestamp of the upload date of the creator's Facebook reel. hashtags: type: array description: Total hashtags included in the Facebook reel. items: type: string required: - id - url - title - videoThumbnail - videoUrl - videoWidth - videoHeight - videoLength - isBroadcast - isStreaming - isPodcast - isGamingVideo - audioTrackType - audioTrackTitle - plays - engageRate - uploadDate - hashtags ````