> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Posts

> Get recent posts from a Threads user. Note: Threads limits public access to approximately the last 20–30 posts per user.

<Note>
  💳 **1 credit** per request
</Note>


## OpenAPI

````yaml GET /v1/scrape/threads/user-posts
openapi: 3.1.0
info:
  title: SociaVault API
  version: 1.0.0
  description: >-
    # SociaVault API Documentation


    The SociaVault API provides comprehensive access to social media data
    extraction across multiple platforms.


    ## Features


    - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
    Reddit, Threads, and more

    - **Credit-Based System**: Pay-as-you-go pricing with transparent credit
    costs

    - **High Performance**: Fast, reliable data extraction

    - **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
    and analytics


    ## Authentication


    All API requests require authentication using an API key in the `X-API-Key`
    header:


    ```bash

    X-API-Key: sk_live_your_api_key_here

    ```


    Get your API key from the [SociaVault
    Dashboard](https://sociavault.com/dashboard).


    ## Credits


    Each endpoint consumes credits based on data complexity:

    - Simple requests (profiles): 1 credit

    - Complex requests (demographics): 20+ credits

    - Paginated requests: Credits per page


    Check your credit balance in the dashboard or via the API.


    ## Support


    - **Documentation**: https://docs.sociavault.com

    - **Email**: support@sociavault.com

    - **Discord**: https://discord.gg/sociavault
  contact:
    name: SociaVault Support
    email: support@sociavault.com
    url: https://sociavault.com/support
  license:
    name: Commercial
    url: https://sociavault.com/terms
servers:
  - url: https://api.sociavault.com
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: account
    description: Account management and credit balance
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/account
  - name: tiktok
    description: Scrape TikTok profiles, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok
  - name: tiktok-shop
    description: Everything about TikTok Shop
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/tiktok-shop
  - name: instagram
    description: Gets Instagram profiles, posts, and reels
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/instagram
  - name: youtube
    description: Scrape YouTube channels, videos, and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/youtube
  - name: linkedin
    description: Scrape LinkedIn
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedin
  - name: facebook
    description: Get public Facebook profiles and posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebook
  - name: facebookAdLibrary
    description: Scrapes the Facebook (Meta) Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookAdLibrary
  - name: facebookMarketplace
    description: Search Facebook Marketplace and pull full listing details
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/facebookMarketplace
  - name: googleAdLibrary
    description: >-
      Scrape the Google Ad Transparency Library. *This only gets the public ads.
      Some ads you need to log in for and sadly we can't get those. Also, since
      there are so many variations, the return types might not all be 100% the
      same.
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/googleAdLibrary
  - name: linkedinAdLibrary
    description: Search the LinkedIn Ad Library
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/linkedinAdLibrary
  - name: twitter
    description: Get Twitter profiles, tweets, followers and more
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/twitter
  - name: reddit
    description: Scrape Reddit posts and comments
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/reddit
  - name: threads
    description: Get Threads posts
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/threads
  - name: google
    description: Scrape Google search results
    externalDocs:
      description: Learn more
      url: https://docs.sociavault.com/platforms/google
paths:
  /v1/scrape/threads/user-posts:
    get:
      tags:
        - threads
      summary: Posts
      description: >-
        Get recent posts from a Threads user. Note: Threads limits public access
        to approximately the last 20–30 posts per user.
      operationId: threads_Posts
      parameters:
        - name: handle
          in: query
          description: Threads username
          required: true
          schema:
            type: string
            example: trendspider
        - name: trim
          in: query
          description: Set to true for a trimmed down version of the response
          required: false
          schema:
            type: boolean
            example: false
      responses:
        '200':
          description: |-
            Successful response

            **Key Response Fields:**
            - `data.posts[n].pk`: Post unique ID
            - `data.posts[n].user.username`: Author Threads handle
            - `data.posts[n].caption.text`: Post text content
            - `data.posts[n].code`: Short post code used in URL construction
            - `data.posts[n].like_count`: Number of likes
            - `data.posts[n].taken_at`: Unix timestamp of post
            - `data.posts[n].text_post_app_info.reshare_count`: Reshare count
            - `data.posts[n].text_post_app_info.direct_reply_count`: Reply count
            - `data.posts[n].url`: Full URL to the post
          content:
            application/json:
              examples:
                full:
                  summary: Full Response
                  value:
                    success: true
                    data:
                      success: true
                      posts:
                        '0':
                          id: '3828488408293886842_63069450921'
                          pk: '3828488408293886842'
                          user:
                            friendship_status: null
                            pk: '63069450921'
                            profile_pic_url: >-
                              https://instagram.fpew3-1.fna.fbcdn.net/v/t51.2885-19/358000025_988841669212235_3183384987691331022_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDAuYzIifQ&_nc_ht=instagram.fpew3-1.fna.fbcdn.net&_nc_cat=111&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=YN92uiZxHdsQ7kNvwEpII6C&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&oh=00_AfvnOwXK5LWdLBCJcT3JhMfK0zwCT95TgnMg-Ap2pXweQA&oe=698F6E15&_nc_sid=d92198
                            username: trendspider
                            id: '63069450921'
                            transparency_label: null
                            transparency_product: null
                            transparency_product_enabled: false
                            is_verified: false
                            text_post_app_is_private: false
                            has_onboarded_to_text_post_app: true
                          text_post_app_info:
                            show_header_follow: false
                            is_markup: false
                            custom_feed_preview_info: null
                            link_preview_attachment: null
                            linked_inline_media: null
                            special_effects_enabled_str: ''
                            text_fragments:
                              fragments:
                                '0':
                                  fragment_type: plaintext
                                  link_fragment: null
                                  mention_fragment: null
                                  plaintext: Bears about to get electrocuted. $XLE ⚡️
                                  tag_fragment: null
                                  linkified_web_url: null
                            reshare_count: 1
                            direct_reply_count: 1
                            repost_count: 1
                            quote_count: 0
                            share_info:
                              quoted_attachment_author_attribution_allowed: true
                              quoted_attachment_post_unavailable: false
                              quoted_attachment_post: null
                              quoted_post: null
                              reposted_post: null
                            reply_to_author: null
                            reply_control: everyone
                            private_reply_partner: null
                            self_thread_count: 0
                            tag_header: null
                            root_post_author: null
                            pinned_post_info:
                              is_pinned_to_parent_post: false
                              is_pinned_to_profile: false
                            related_trends_info: null
                            is_reply: false
                            is_post_unavailable: false
                            post_unavailable_reason: null
                            hush_info: null
                          is_paid_partnership: null
                          audio: null
                          caption:
                            text: Bears about to get electrocuted. $XLE ⚡️
                            pk: '18124847122482968'
                            has_translation: null
                          caption_is_edited: false
                          transcription_data: null
                          carousel_media: null
                          code: DUhhexTDst6
                          image_versions2:
                            candidates:
                              '0':
                                height: 790
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AftwC9O9IUwbpyRO1tC72wA3rBRVkcRgQir0abJXO7tifA&oe=698F6A8A&_nc_sid=d92198
                                width: 1079
                              '1':
                                height: 527
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s720x720_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_Aft_FORzSXbDVHbLlM6xjp38uLfK_51VJoc4qothIwsYuw&oe=698F6A8A&_nc_sid=d92198
                                width: 720
                              '2':
                                height: 469
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s640x640_sh0.08_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuQxWY2Oy3Q1qrjr7-qkVwfboWGEynLv79Zb1GqiJzV4w&oe=698F6A8A&_nc_sid=d92198
                                width: 640
                              '3':
                                height: 351
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s480x480_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AftLIsxKm4vynot2_6n_zg0Dg7Yf-W3K4JTi8KmTRK8Uog&oe=698F6A8A&_nc_sid=d92198
                                width: 480
                              '4':
                                height: 234
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_Afv83ey5vozo49h6PNh_0J4lCGSrB7Fes3zURauk_qMO6Q&oe=698F6A8A&_nc_sid=d92198
                                width: 320
                              '5':
                                height: 176
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=dst-jpg_e35_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AftJe9Zb8GhkRmz98lnHHbMwyIUBsDcBiz9kp0tipweuMQ&oe=698F6A8A&_nc_sid=d92198
                                width: 240
                              '6':
                                height: 790
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuNu1KkMaCH2DnW-PuVxk63ypYya1usgel8elJc-Nu1Og&oe=698F6A8A&_nc_sid=d92198
                                width: 790
                              '7':
                                height: 750
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s750x750_sh0.08_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuGChCxSlp0mZ8spmB7DMrHUyFtnH1fNrHBgn8Zgjx5YQ&oe=698F6A8A&_nc_sid=d92198
                                width: 750
                              '8':
                                height: 640
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s640x640_sh0.08_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfsLboFlhH1k1nbBamO0ZxfZlGx-hFrue9Lr-JKupAQQxg&oe=698F6A8A&_nc_sid=d92198
                                width: 640
                              '9':
                                height: 480
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s480x480_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfvQ46R_XvLms_myEqfJ2Do9D9sPWwbBNoGwQSt9Tk9ZvA&oe=698F6A8A&_nc_sid=d92198
                                width: 480
                              '10':
                                height: 320
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfvkfR-WeWgVGyD3KzQfS4z_UKCjuVyI-8_WRPhWcXQarw&oe=698F6A8A&_nc_sid=d92198
                                width: 320
                              '11':
                                height: 240
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_AfuujlVCNDe7BuL-Kbu6f55QX6L2mIWGUFVm_D6h89AuhA&oe=698F6A8A&_nc_sid=d92198
                                width: 240
                              '12':
                                height: 150
                                url: >-
                                  https://instagram.fpew4-1.fna.fbcdn.net/v/t51.2885-15/629017309_17947866438098922_3617815627980895312_n.jpg?stp=c144.0.790.790a_dst-jpg_e35_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InRocmVhZHMuRkVFRC5pbWFnZV91cmxnZW4uMTA3OXg3OTAuc2RyLmY4Mjc4Ny5kZWZhdWx0X2ltYWdlLmMyIn0&_nc_ht=instagram.fpew4-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QH1Zttf7sOqUajuXvfZKuhJouW3rTyvzGG8LNrf38Krqw1lLXemYTvbbEs70zeRM8w&_nc_ohc=hyrKboqlgdAQ7kNvwFkzn0N&_nc_gid=h0ee9dEkIHIUOLQ4kYPk0g&edm=AA3DLpEBAAAA&ccb=7-5&ig_cache_key=MzgyODQ4ODQwODI5Mzg4Njg0Mg%3D%3D.3-ccb7-5&oh=00_Afs6WTaZn4G9zZeqtUw_pv8-reqbLJSTd6aOomAUb8KuMA&oe=698F6A8A&_nc_sid=d92198
                                width: 150
                          original_height: 790
                          original_width: 1079
                          accessibility_caption: >-
                            May be an image of text that says "TrendSpider Trend
                            Spider XLE Weekly, Candles XLE,Weekly,Candles.chart
                            chart Neekly Weekly XLE 53.25 45.16 44.24 41 41.89
                            89 62020 TrendSpider 74.59"
                          video_versions: null
                          has_audio: null
                          media_type: 1
                          caption_add_on: null
                          giphy_media_info: null
                          media_overlay_info: null
                          sharing_friction_info:
                            should_have_sharing_friction: false
                            sharing_friction_payload: null
                          like_count: 19
                          metaPlace: null
                          meta_place: null
                          gen_ai_detection_method: null
                          taken_at: 1770611422
                          organic_tracking_token: >-
                            eyJ2ZXJzaW9uIjo1LCJwYXlsb2FkIjp7ImlzX2FuYWx5dGljc190cmFja2VkIjp0cnVlLCJ1dWlkIjoiNjkzN2IyMGUyYzkwNGEyODg5NDU0NjZlOTkxODBiN2UzODI4NDg4NDA4MjkzODg2ODQyIn0sInNpZ25hdHVyZSI6IiJ9
                          logging_info_token: null
                          like_and_view_counts_disabled: false
                          url: >-
                            https://www.threads.com/@trendspider/post/DUhhexTDst6
                    credits_used: 1
                    endpoint: user-posts
                trimmed:
                  summary: Trimmed Response
                  value:
                    success: true
                    data:
                      success: true
                      posts:
                        '0':
                          id: '3828488408293886842_63069450921'
                          pk: '3828488408293886842'
                          caption:
                            text: Bears about to get electrocuted. $XLE ⚡️
                            pk: '18124847122482968'
                            has_translation: null
                          code: DUhhexTDst6
                          like_count: 19
                          taken_at: 1770611422
                          user:
                            friendship_status: null
                            pk: '63069450921'
                            profile_pic_url: >-
                              https://instagram.flhr14-1.fna.fbcdn.net/v/t51.2885-19/358000025_988841669212235_3183384987691331022_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MDAuYzIifQ&_nc_ht=instagram.flhr14-1.fna.fbcdn.net&_nc_cat=111&_nc_oc=Q6cZ2QGZWmC84jZ9njTBrUVJDJ8uY2_qUvpheJk_iqcvdlsc40xXyZfxkhEK7xQ7vd6AzBY&_nc_ohc=YN92uiZxHdsQ7kNvwHN7Rdj&_nc_gid=o8YkmVncW3PEUvCSsmmW5g&edm=AA3DLpEBAAAA&ccb=7-5&oh=00_AfuLPpwUh2POrMPXHktFv-NLqtflSMhMaBH7wrVHIYiqjQ&oe=698F6E15&_nc_sid=d92198
                            username: trendspider
                            id: '63069450921'
                            transparency_label: null
                            transparency_product: null
                            transparency_product_enabled: false
                            is_verified: false
                            text_post_app_is_private: false
                            has_onboarded_to_text_post_app: true
                          url: >-
                            https://www.threads.com/@trendspider/post/DUhhexTDst6
                    credits_used: 1
                    endpoint: user-posts
        '400':
          description: Bad Request - Invalid parameters or missing required fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: 'Missing required parameter: handle'
                  endpoint:
                    type: string
                  credits_required:
                    type: integer
                required:
                  - error
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Invalid API key
                  docs:
                    type: string
                    example: https://docs.sociavault.com/authentication
                required:
                  - error
        '402':
          description: Payment Required - Insufficient credits
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Insufficient credits
                  required:
                    type: integer
                    example: 1
                    description: Credits required for this request
                  available:
                    type: integer
                    example: 0
                    description: Credits currently available
                required:
                  - error
                  - required
                  - available
        '500':
          description: Internal Server Error - Service configuration or processing error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Service configuration error
                required:
                  - error
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`

        Get your API key from the [Dashboard](https://sociavault.com/dashboard).

````