> ## 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 Threads historical data

> Get the basic metrics and historical data of a creator's Threads account.



## OpenAPI

````yaml /api-v2/api-v2.yaml get /threadsHistory
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:
  /threadsHistory:
    get:
      tags:
        - Threads
      summary: Get Threads historical data
      description: >-
        Get the basic metrics and historical data of a creator's Threads
        account.
      operationId: getThreadsHistory
      parameters:
        - name: apiId
          in: header
          description: ''
          required: true
          schema:
            type: string
            examples:
              - LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W
        - name: threadsId
          in: query
          description: ''
          required: true
          schema:
            type: string
            examples:
              - threads
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BasicThreadsAndHistoryResult'
                  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:
                      basicThreads:
                        threadsId: threads
                        threadsName: Threads
                        avatar: >-
                          https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/450786907_1174411147130821_4003196044560483250_n.jpg?stp=dst-jpg_s320x320_tt6&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2AFTKEobeNNExwZAffcFeOAZ-Ew61DyLYjXWqdrUM-4EPY9fWAR706dMkTL5LbzIg9w&_nc_ohc=i3Sz-LesOnsQ7kNvgFZ9L9e&_nc_gid=cfc0ebe003e44c809c62cbf18fcfac7a&edm=APs17CUBAAAA&ccb=7-5&oh=00_AYGlJNxESfmxpdtW-9soMm9qnkJzF8XeQKyeKMA2d6cWLg&oe=67D83F85&_nc_sid=10d13b
                        description: Everyone has something worth saying ✨
                        hashtags: []
                        links:
                          - title: ''
                            url: https://creators.instagram.com/threads
                        followers: 4616766
                        gRateFollowers: 0.00356226038844291
                        gRateThreadsTabPosts: -0.15280135823429541
                        gRateThreadsTabAvgReplies: 0.3867556284830556
                        gRateThreadsTabAvgLikes: 0.3984427067609212
                        gRateRepliesTabPosts: 0
                        gRateRepliesTabAvgReplies: 0
                        gRateRepliesTabAvgLikes: 0
                        recentThreads:
                          - id: '3586655058328136718'
                            lastUploadDate: 1741782623000
                            posts:
                              - shortcode: DHGW8XLgawO
                                authorThreadsId: threads
                                uploadDate: 1741782623000
                                replies: 743
                                likes: 6715
                                postType: slideshow
                                images:
                                  - >-
                                    https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-15/483702053_17903647998102532_7378214737466453542_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xNDQweDE0NDAuc2RyLmY3NTc2MS5kZWZhdWx0X2ltYWdlIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2AEpT9iU7h0Eckoo07sqUbajIX1u2dwG-ai_yCGIkUl2dCsfKPrxnDkdMl-QCYlpxL4&_nc_ohc=hToKB62pchcQ7kNvgEpLO8B&_nc_gid=0336f6208aae48aba6024ebbc2144ef4&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU4NjY1NTA1MTc5MzQ1NTA0Ng%3D%3D.3-ccb7-5&oh=00_AYEZv622uAfcLBYyhsxMp2bmJjg08VjB3R3qp88nO7UUFw&oe=67D85F65&_nc_sid=10d13b
                                  - >-
                                    https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-15/483737195_17903648052102532_987390742752956861_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xNDQweDE0NDAuc2RyLmY3NTc2MS5kZWZhdWx0X2ltYWdlIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2AEpT9iU7h0Eckoo07sqUbajIX1u2dwG-ai_yCGIkUl2dCsfKPrxnDkdMl-QCYlpxL4&_nc_ohc=VHe-9caWPuAQ7kNvgE2l_Xe&_nc_gid=0336f6208aae48aba6024ebbc2144ef4&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU4NjY1NTA1MjAxMTQ1NzA3MQ%3D%3D.3-ccb7-5&oh=00_AYGm345pTsBJdim3BWKd_eOuo0icN0Gq9HF0jlLGszubQw&oe=67D84B93&_nc_sid=10d13b
                                  - >-
                                    https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-15/484084053_17903648028102532_7817949458921719236_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xNDQweDE0NDAuc2RyLmY3NTc2MS5kZWZhdWx0X2ltYWdlIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2AEpT9iU7h0Eckoo07sqUbajIX1u2dwG-ai_yCGIkUl2dCsfKPrxnDkdMl-QCYlpxL4&_nc_ohc=rBxWXepaDwoQ7kNvgE_Qr2h&_nc_gid=0336f6208aae48aba6024ebbc2144ef4&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU4NjY1NTA1MTc5MzUwNjUyMw%3D%3D.3-ccb7-5&oh=00_AYFYdF5BlDk56bDPobY6EQr99axBW7RHgwrZydx2ll_1jg&oe=67D86083&_nc_sid=10d13b
                                title: hello
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                          - id: '3586896515924804207'
                            lastUploadDate: 1741811407000
                            posts:
                              - shortcode: DHHN2CFyMJv
                                authorThreadsId: threads
                                uploadDate: 1741811407000
                                replies: 160
                                likes: 532
                                postType: poll
                                images: []
                                title: 'The most underrated Girl Scout cookie:'
                                audioUrl: ''
                                pollTallies:
                                  - count: 1423
                                    text: Samoas 🥥
                                  - count: 766
                                    text: Tagalongs 🥜
                                  - count: 715
                                    text: Trefoils 🍪
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                          - id: '3586103357745695631'
                            lastUploadDate: 1741716855000
                            posts:
                              - shortcode: DHEZgD-RIuP
                                authorThreadsId: threads
                                uploadDate: 1741716855000
                                replies: 526
                                likes: 2898
                                postType: text_only
                                images: []
                                title: >-
                                  ICYMI: If you've posted a thread with photos
                                  or video, it'll appear under the new Media tab
                                  on your profile 📸
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                        recentReplies:
                          - id: '3542680352663567717'
                            lastUploadDate: 1736540429000
                            posts:
                              - shortcode: DEpPYAXNJ_J
                                authorThreadsId: jamesblunt
                                uploadDate: 1736510609000
                                replies: 177
                                likes: 3932
                                postType: slideshow
                                images:
                                  - >-
                                    https://scontent-fra3-1.cdninstagram.com/v/t51.29350-15/473388289_1028144635742429_8205422521321878644_n.jpg?stp=dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xNDQweDE4MDAuc2RyLmYyOTM1MC5kZWZhdWx0X2ltYWdlIn0&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_ohc=_aTZu-dIsNwQ7kNvgHKa5ep&_nc_gid=27351cc26ef049b0a63552f6ea240755&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU0MjQzMDE5MTM5NDc1MTA1Mw%3D%3D.3-ccb7-5&oh=00_AYC5aUz2UCvnQGBlPoJsU2fM8XPiaJPvdWitV8kk8GTorw&oe=6789C9F0&_nc_sid=10d13b
                                  - >-
                                    https://scontent-fra3-2.cdninstagram.com/v/t51.29350-15/472883964_588313717253099_6202757644549638973_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi43MjB4ODk5LnNkci5mMjkzNTAuZGVmYXVsdF9pbWFnZSJ9&_nc_ht=scontent-fra3-2.cdninstagram.com&_nc_cat=111&_nc_ohc=ONQWv0HYH9gQ7kNvgEklkaH&_nc_gid=27351cc26ef049b0a63552f6ea240755&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU0MjQzMDE5MTI3NzQxNzUwNA%3D%3D.3-ccb7-5&oh=00_AYBi90W5TVlQmTwvRUc5JBsZLVs9taPws1Fy_ZmVu7etFA&oe=6789DC5B&_nc_sid=10d13b
                                title: >-
                                  I’ve been a pizza, a horse and a chairlift,
                                  but nothing beats being a burger!


                                  @shed.burgers.verbier
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                              - shortcode: DEqIQLFRH1l
                                authorThreadsId: threads
                                uploadDate: 1736540429000
                                replies: 36
                                likes: 830
                                postType: text_only
                                images: []
                                title: That burger’s beautiful, it’s true
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: reply
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: jamesblunt
                                lineType: ''
                          - id: '3542646337781065929'
                            lastUploadDate: 1736536374000
                            posts:
                              - shortcode: DEpYzm9RI6i
                                authorThreadsId: rexymulone
                                uploadDate: 1736515554000
                                replies: 30
                                likes: 417
                                postType: slideshow
                                images:
                                  - >-
                                    https://scontent-fra3-1.cdninstagram.com/v/t51.2885-15/472980099_18482257906038785_1650997142398309222_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42NDh4NDczLnNkci5mNzU3NjEuZGVmYXVsdF9pbWFnZSJ9&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_ohc=YV64kQfeMFcQ7kNvgGf4w3l&_nc_gid=27351cc26ef049b0a63552f6ea240755&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU0MjQ3MTY2Nzk1MzkzNTAxMw%3D%3D.3-ccb7-5&oh=00_AYCIorBpXGjJKBb2xSGYGYYUEwkebtIgob1WiwcECHkm0A&oe=6789DF87&_nc_sid=10d13b
                                  - >-
                                    https://scontent-fra3-1.cdninstagram.com/v/t51.2885-15/472500468_18482257915038785_7016743808294799428_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi42MTR4NDUxLnNkci5mNzU3NjEuZGVmYXVsdF9pbWFnZSJ9&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_ohc=PO50ID_8-3EQ7kNvgGBD2Ze&_nc_gid=27351cc26ef049b0a63552f6ea240755&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU0MjQ3MTY2ODAyOTQ0MjU2NA%3D%3D.3-ccb7-5&oh=00_AYAtDT6AEODyvi40SlpNY59ryXK2E4arGPhJC0DSsFV5Ew&oe=6789C2B1&_nc_sid=10d13b
                                  - >-
                                    https://scontent-fra3-1.cdninstagram.com/v/t51.2885-15/472652048_18482257924038785_8467329164289446629_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi41NTR4NDA2LnNkci5mNzU3NjEuZGVmYXVsdF9pbWFnZSJ9&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_ohc=L6b7R3FMI1YQ7kNvgEf_Jh1&_nc_gid=27351cc26ef049b0a63552f6ea240755&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzU0MjQ3MTY2ODE0Njg1OTY0Ng%3D%3D.3-ccb7-5&oh=00_AYD8fAda4YLSmhXRxeGF_0LXdMjlzjXT6zDdMGJLLJdiKw&oe=6789D8C6&_nc_sid=10d13b
                                title: >-
                                  One year of consistent yoga. I’m really amazed
                                  at how far I’ve come and I have loved every
                                  moment of it. It has been challenging but so
                                  rewarding. I feel stronger and more fit than I
                                  have in my entire life and I am doing things
                                  that I never thought I’d be able to do. I’m
                                  more mindful and aware of my breath throughout
                                  the day and I would say that this practice has
                                  improved every aspect of my life. This is
                                  pretty cool.
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                              - shortcode: DEqAhMQR2jJ
                                authorThreadsId: threads
                                uploadDate: 1736536374000
                                replies: 18
                                likes: 365
                                postType: text_only
                                images: []
                                title: Nothing beats finding a practice you love 🫶
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: reply
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: rexymulone
                                lineType: ''
                          - id: '3542003978219677460'
                            lastUploadDate: 1736459799000
                            posts:
                              - shortcode: DElB86RTzAP
                                authorThreadsId: missjasmineshah
                                uploadDate: 1736369354000
                                replies: 277
                                likes: 4382
                                postType: text_only
                                images: []
                                title: >-
                                  I started a notes folder called “beautiful
                                  things that happened in 2025” to help me keep
                                  track of all the little & big moments of this
                                  year.
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                              - shortcode: DEnudoSzecU
                                authorThreadsId: threads
                                uploadDate: 1736459799000
                                replies: 33
                                likes: 979
                                postType: text_only
                                images: []
                                title: Love this idea 🫶
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: reply
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: missjasmineshah
                                lineType: ''
                        recentReposts:
                          - id: '3539664804619075643'
                            lastUploadDate: 1736180948000
                            posts:
                              - repostedDate: 1736180948000
                                shortcode: DEfaCvDvgVb
                                authorThreadsId: emmyloop
                                uploadDate: 1736180658000
                                replies: 115
                                likes: 344
                                postType: text_only
                                images: []
                                title: >-
                                  Something I’d love to do more in the new year
                                  – hearing from all of you about how we can
                                  make Threads better. We’re cooking up an AMA
                                  session this Wednesday on @threads, where our
                                  product team will answer questions directly,
                                  but in the meantime, I’d love to hear about
                                  everything you think we should build or fix on
                                  the app! Hit me up in the replies.
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                          - id: '3539283689789210583'
                            lastUploadDate: 1736135515000
                            posts:
                              - repostedDate: 1736135515000
                                shortcode: DEdduzZP_UH
                                authorThreadsId: oficialfernandatorres
                                uploadDate: 1736115483000
                                replies: 1554
                                likes: 78118
                                postType: photo
                                images:
                                  - >-
                                    https://scontent-fra5-2.cdninstagram.com/v/t51.2885-15/472739459_18293561899236882_4926392237124540775_n.jpg?stp=dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xNDA2eDE3NTguc2RyLmY3NTc2MS5kZWZhdWx0X2ltYWdlIn0&_nc_ht=scontent-fra5-2.cdninstagram.com&_nc_cat=106&_nc_ohc=hEll8xhHpv8Q7kNvgHAjnjN&_nc_gid=1389ca76d96f41138fdb704f5635c89e&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzUzOTExNTY0MTgxMjI4NDY3OQ%3D%3D.3-ccb7-5&oh=00_AYA3LJG_0E_SkgK_6kRZBRQrKCpCZ25F5vWz67BZqzbbTw&oe=6789F007&_nc_sid=10d13b
                                title: |-
                                  A Caminho!

                                  #GoldenGlobes #ImStillHere
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags: []
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                          - id: '3539267895509337725'
                            lastUploadDate: 1736133633000
                            posts:
                              - repostedDate: 1736133633000
                                shortcode: DEd_0iANK31
                                authorThreadsId: abbeybonadies
                                uploadDate: 1736133355000
                                replies: 3
                                likes: 812
                                postType: photo
                                images:
                                  - >-
                                    https://scontent-fra5-2.cdninstagram.com/v/t51.29350-15/472445767_1644585833077842_8693441090930966802_n.jpg?stp=cp6_dst-jpg_e15_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6ImltYWdlX3VybGdlbi4xMDgweDc1NS5zZHIuZjI5MzUwLmRlZmF1bHRfaW1hZ2UifQ&_nc_ht=scontent-fra5-2.cdninstagram.com&_nc_cat=106&_nc_ohc=RytP43opqAcQ7kNvgFhLWnz&_nc_gid=1389ca76d96f41138fdb704f5635c89e&edm=APs17CUBAAAA&ccb=7-5&ig_cache_key=MzUzOTI2NTU2OTAzNjc0MjEzMw%3D%3D.3-ccb7-5&oh=00_AYAhFxDh8xoXn6euIjFoQgpUdANcVKDE2V_wwpctLAZBYg&oe=6789C775&_nc_sid=10d13b
                                title: >-
                                  LISTEN TO JON M CHU'S WORDS!!!! HE IS GRATEFUL
                                  FOR US!!! THE PEOPLE WHO MADE WICKED WHAT IT
                                  IS THROUGH LOVE, CARE, AND FANDOM!!! Adorable
                                  x 10000000!!!!!!
                                audioUrl: ''
                                pollTallies: []
                                giphyWebpUrl: ''
                                links: []
                                hashtags:
                                  - WICKED
                                publishType: general
                                quotedPost: null
                                quotedText: ''
                                replyToThreadsId: ''
                                lineType: ''
                      histories:
                        - timestamp: 1741795200000
                          followers: 4616766
                          threadsTabPosts: 32
                          threadsTabAvgReplies: 881.59375
                          threadsTabAvgLikes: 7994.59375
                          repliesTabPosts: 25
                          repliesTabAvgReplies: 17.32
                          repliesTabAvgLikes: 432.64
                        - timestamp: 1741536000000
                          followers: 4615876
                          threadsTabPosts: 34
                          threadsTabAvgReplies: 1008.8235294117648
                          threadsTabAvgLikes: 7986.882352941177
                          repliesTabPosts: 25
                          repliesTabAvgReplies: 17.32
                          repliesTabAvgLikes: 432.64
                        - timestamp: 1741363200000
                          followers: 4616681
                          threadsTabPosts: 34
                          threadsTabAvgReplies: 1039.264705882353
                          threadsTabAvgLikes: 8179.764705882353
                          repliesTabPosts: 25
                          repliesTabAvgReplies: 17.32
                          repliesTabAvgLikes: 432.64
                    quotaUsed: 3
                    quotaUsedTotal: 6027
                    remainingPlanCredit: 993973
                    remainingPrepurchasedCredit: 0
                    timestamp: 1755503515725
                    error: ''
                    success: true
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BasicThreadsAndHistoryResult'
                  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: 1755503514451
                    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/threadsHistory?threadsId=threads' \
              --header 'Accept: application/json' \
              --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' 
components:
  schemas:
    BasicThreadsAndHistoryResult:
      type: object
      additionalProperties: false
      properties:
        basicThreads:
          $ref: '#/components/schemas/BasicThreads'
        histories:
          type: array
          items:
            $ref: '#/components/schemas/ThreadsHistoryDay'
      required:
        - basicThreads
        - histories
    BasicThreads:
      type: object
      additionalProperties: false
      properties:
        threadsId:
          type: string
          description: User ID of the Threads account.
        threadsName:
          type: string
          description: Username of the Threads account.
        avatar:
          type: string
          description: Profile picture link of the Threads account.
        description:
          type: string
          description: Biography description of the Threads account.
        hashtags:
          type: array
          description: Hashtags that are included in the Threads post.
          items:
            type: string
        links:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              title:
                type: string
                description: The name of the link on the About page of the Threads account.
              url:
                type: string
                description: URL of the link on the About page of the Threads account.
            required:
              - title
              - url
        followers:
          type: number
          description: The number of followers of the Threads account.
        gRateFollowers:
          type: number
          description: The Threads account followers growth rate from the last 30 days.
        gRateThreadsTabPosts:
          type: number
          description: The thread growth rate from the last 30 days.
        gRateThreadsTabAvgReplies:
          type: number
          description: The growth rate of average replies per thread from the last 30 days.
        gRateThreadsTabAvgLikes:
          type: number
          description: The growth rate of average likes per thread from the last 30 days.
        gRateRepliesTabPosts:
          type: number
          description: The growth rate of replies from the last 30 days.
        gRateRepliesTabAvgReplies:
          type: number
          description: >-
            The average replies per post growth rate in the Replies tab from the
            last 30 days.
        gRateRepliesTabAvgLikes:
          type: number
          description: >-
            The growth rate of the average likes per reply from the last 30
            days.
        recentThreads:
          type: array
          items:
            $ref: '#/components/schemas/ThreadsPostGroupInfo'
        recentReplies:
          type: array
          items:
            $ref: '#/components/schemas/ThreadsPostGroupInfo'
        recentReposts:
          type: array
          items:
            $ref: '#/components/schemas/ThreadsRepostGroupInfo'
      required:
        - threadsId
        - threadsName
        - avatar
        - description
        - hashtags
        - links
        - followers
        - gRateFollowers
        - gRateThreadsTabPosts
        - gRateThreadsTabAvgReplies
        - gRateThreadsTabAvgLikes
        - gRateRepliesTabPosts
        - gRateRepliesTabAvgReplies
        - gRateRepliesTabAvgLikes
        - recentThreads
        - recentReplies
        - recentReposts
    ThreadsHistoryDay:
      type: object
      additionalProperties: false
      properties:
        timestamp:
          type: number
          description: >-
            Unix timestamp of the Threads data snapshot. Returns data from the
            past 365 days.
        followers:
          type: number
          description: Followers of the Threads' account on a specified date in the past.
        threadsTabPosts:
          type: number
          description: Total threads on the specified date in the past.
        threadsTabAvgReplies:
          type: number
          description: Average replies per thread on the specified date in the past.
        threadsTabAvgLikes:
          type: number
          description: Average likes per thread on the specified date in the past.
        repliesTabPosts:
          type: number
          description: Total replies on the specified date in the past.
        repliesTabAvgReplies:
          type: number
          description: >-
            Average replies per post in the Replies tab on the specified date in
            the past.
        repliesTabAvgLikes:
          type: number
          description: >-
            Average likes per post in the Replies tab on the specified date in
            the past.
      required:
        - timestamp
        - followers
        - threadsTabPosts
        - threadsTabAvgReplies
        - threadsTabAvgLikes
        - repliesTabPosts
        - repliesTabAvgReplies
        - repliesTabAvgLikes
    ThreadsPostGroupInfo:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique ID of a thread.
        lastUploadDate:
          type: number
          description: Unix timestamp of the latest post in a thread.
        posts:
          type: array
          description: A post or reply to a thread.
          items:
            $ref: '#/components/schemas/ThreadsPostInfo'
      required:
        - id
        - lastUploadDate
        - posts
    ThreadsRepostGroupInfo:
      type: object
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique ID of the reposted post.
        lastUploadDate:
          type: number
          description: Unix timestamp of the last post publish time in a reposted post.
        posts:
          type: array
          description: The post or reply in a reposted post.
          items:
            $ref: '#/components/schemas/ThreadsRepostInfo'
      required:
        - id
        - lastUploadDate
        - posts
    ThreadsPostInfo:
      type: object
      additionalProperties: false
      properties:
        shortcode:
          type: string
          description: The unique ID of the content
        authorThreadsId:
          type: string
          description: The account ID of the author who created the content
        uploadDate:
          type: number
          description: The Unix timestamp of when the content was created
        replies:
          type: number
          description: The total number of replies
        likes:
          type: number
          description: The total number of likes
        postType:
          type: string
          enum:
            - photo
            - slideshow
            - video
            - audio
            - poll
            - giphy
            - link_contained
            - text_only
            - other
          description: The type of content, such as video, audio, or photo
        images:
          type: array
          description: The URLs of images displayed in the content
          items:
            type: string
        title:
          type: string
          description: The caption of the content
        audioUrl:
          type: string
          description: Deprecated.
        pollTallies:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              count:
                type: number
                description: The number of votes for each poll option
              text:
                type: string
                description: The text of each poll option
            required:
              - count
              - text
        giphyWebpUrl:
          type: string
          description: The URLs of giphys displayed in the content
        links:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              title:
                type: string
                description: The metadata title of the linked page displayed in the content
              url:
                type: string
                description: The URL of the linked page displayed in the content
            required:
              - title
              - url
        hashtags:
          type: array
          description: Hashtags used in the content caption
          items:
            type: string
        publishType:
          type: string
          enum:
            - reply
            - repost
            - quote
            - general
          description: >-
            The platform-defined content type, such as general, quote, reply, or
            repost
        quotedPost:
          description: The quoted content in the original content
          anyOf:
            - $ref: '#/components/schemas/ThreadsPostInfo'
            - type: 'null'
        quotedText:
          type: string
          description: The quoted text in the content
        replyToThreadsId:
          type: string
          description: The Threads account ID of the commenter
        lineType:
          type: string
      required:
        - shortcode
        - authorThreadsId
        - uploadDate
        - replies
        - likes
        - postType
        - images
        - title
        - audioUrl
        - pollTallies
        - giphyWebpUrl
        - links
        - hashtags
        - publishType
        - quotedPost
        - quotedText
        - replyToThreadsId
        - lineType
    ThreadsRepostInfo:
      type: object
      additionalProperties: false
      properties:
        shortcode:
          type: string
          description: The unique ID of the content
        authorThreadsId:
          type: string
          description: The account ID of the author who created the content
        uploadDate:
          type: number
          description: The Unix timestamp of when the content was created
        replies:
          type: number
          description: The total number of replies
        likes:
          type: number
          description: The total number of likes
        postType:
          type: string
          enum:
            - photo
            - slideshow
            - video
            - audio
            - poll
            - giphy
            - link_contained
            - text_only
            - other
          description: The type of content, such as video, audio, or photo
        images:
          type: array
          description: The URLs of images displayed in the content
          items:
            type: string
        title:
          type: string
          description: The caption of the content
        audioUrl:
          type: string
          description: Deprecated.
        pollTallies:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              count:
                type: number
                description: The number of votes for each poll option
              text:
                type: string
                description: The text of each poll option
            required:
              - count
              - text
        giphyWebpUrl:
          type: string
          description: The URLs of giphys displayed in the content
        links:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              title:
                type: string
                description: The metadata title of the linked page displayed in the content
              url:
                type: string
                description: The URL of the linked page displayed in the content
            required:
              - title
              - url
        hashtags:
          type: array
          description: Hashtags used in the content caption
          items:
            type: string
        publishType:
          type: string
          enum:
            - reply
            - repost
            - quote
            - general
          description: >-
            The platform-defined content type, such as general, quote, reply, or
            repost
        quotedPost:
          description: The quoted content in the original content
          anyOf:
            - $ref: '#/components/schemas/ThreadsPostInfo'
            - type: 'null'
        quotedText:
          type: string
          description: The quoted text in the content
        replyToThreadsId:
          type: string
          description: The Threads account ID of the commenter
        lineType:
          type: string
        repostedDate:
          type: number
          description: Unix timestamp of when the Threads post was reposted.
      required:
        - shortcode
        - authorThreadsId
        - uploadDate
        - replies
        - likes
        - postType
        - images
        - title
        - audioUrl
        - pollTallies
        - giphyWebpUrl
        - links
        - hashtags
        - publishType
        - quotedPost
        - quotedText
        - replyToThreadsId
        - lineType
        - repostedDate

````