> ## 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.

# Search

> Search Twitter for tweets, users, photos, media, and more. Results are paginated — use the cursor parameter to fetch additional pages.

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


## OpenAPI

````yaml GET /v1/scrape/twitter/search
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/twitter/search:
    get:
      tags:
        - twitter
      summary: Search
      description: >-
        Search Twitter for tweets, users, photos, media, and more. Results are
        paginated — use the cursor parameter to fetch additional pages.
      operationId: twitter_Search
      parameters:
        - name: query
          in: query
          description: The search query text
          required: true
          schema:
            type: string
            example: AI
        - name: type
          in: query
          description: >-
            The type of search results to return. Defaults to Top if not
            provided.
          required: false
          schema:
            type: string
            enum:
              - Top
              - Latest
              - People
              - Photos
              - Media
              - Lists
            default: Top
            example: Top
        - name: cursor
          in: query
          description: >-
            Pagination cursor from a previous response to get the next page of
            results
          required: false
          schema:
            type: string
      responses:
        '200':
          description: >-
            Successful response


            **Key Response Fields:**


            **Pagination:**

            - `data.cursor.bottom`: Pass as `cursor` query param to get the next
            page of results

            - `data.cursor.top`: Cursor for the previous/newer page


            **Search Results (type=Top):**

            - `data.result.timeline.instructions[0].entries[]`: Array of result
            entries (type `TimelineAddEntries`)


            **People Carousel** (first entry when type=Top):

            - `entries[0].content.items[]`: Array of matched user profiles
            displayed in a carousel

            - `entries[0].content.header.text`: Will be `People`

            - Each user at `.item.itemContent.user_results.result`:
              - `.rest_id`: User's numeric ID
              - `.is_blue_verified`: Blue checkmark status
              - `.legacy.name`: Display name
              - `.legacy.screen_name`: Handle (username without @)
              - `.legacy.description`: Bio
              - `.legacy.followers_count`: Follower count
              - `.legacy.friends_count`: Following count
              - `.legacy.profile_image_url_https`: Profile picture URL
              - `.legacy.verified_type`: `Business` for business accounts

            **Tweet Results** (subsequent entries):

            - Each tweet at
            `entries[].content.itemContent.tweet_results.result`:
              - `.rest_id`: Tweet ID
              - `.legacy.full_text`: Tweet text
              - `.legacy.created_at`: Timestamp
              - `.views.count`: View count (string)
              - `.legacy.favorite_count`: Likes
              - `.legacy.retweet_count`: Retweets
              - `.legacy.reply_count`: Replies
              - `.legacy.quote_count`: Quote tweets
              - `.legacy.bookmark_count`: Bookmarks

            **Feedback Actions:**

            - `data.result.timeline.responseObjects.feedbackActions[]`: Internal
            feedback metadata (can ignore)
          content:
            application/json:
              example:
                success: true
                data:
                  error: false
                  cursor:
                    bottom: >-
                      DAACCgACHC_nhDeAJxAKAAMcL-eEN3_Y8AgABAAAAAILAAUAAADoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJNY0xKTVpCQnVSZVJ3cnBxOHZGN0NrSEM2bGtMWVhBWnNjTHcwR2JocmdlaHdsYXEvbG0xQnVIQjlJMUVlYXdkUWNKNjhCaXRyQkNod3JETnJjR2xFekhCRFRFRnNiRVMwY0txa3pSSnBRWXh2L0VBcW5tOURJSENwYlExVGF3TGtjTDVFK3h4dWhRUndzWDl1c0dsR3FIQnl5b1VuYkFkd2I5alY0alZiZ2h4d3U1ckxaRmhFVkhDVTI5Sk1ha1B3Y0p6VFhldHRoM1E9PQgABgAAAAAIAAcAAAAADAAICgABG_8QCqeb0MgAAAA
                    top: >-
                      DAACCgACHC_nhDeAJxAKAAMcL-eEN3_Y8AgABAAAAAELAAUAAADoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJNY0xKTVpCQnVSZVJ3cnBxOHZGN0NrSEM2bGtMWVhBWnNjTHcwR2JocmdlaHdsYXEvbG0xQnVIQjlJMUVlYXdkUWNKNjhCaXRyQkNod3JETnJjR2xFekhCRFRFRnNiRVMwY0txa3pSSnBRWXh2L0VBcW5tOURJSENwYlExVGF3TGtjTDVFK3h4dWhRUndzWDl1c0dsR3FIQnl5b1VuYkFkd2I5alY0alZiZ2h4d3U1ckxaRmhFVkhDVTI5Sk1ha1B3Y0p6VFhldHRoM1E9PQgABgAAAAAIAAcAAAAADAAICgABG_8QCqeb0MgAAAA
                  result:
                    timeline:
                      instructions:
                        - entries:
                            - content:
                                __typename: TimelineTimelineModule
                                clientEventInfo:
                                  component: user_module
                                  element: module
                                displayType: Carousel
                                entryType: TimelineTimelineModule
                                footer:
                                  displayType: Classic
                                  landingUrl:
                                    url: >-
                                      twitter://search?query=AI&src=typed_query&type=users
                                    urlType: DeepLink
                                  text: View all
                                header:
                                  displayType: Classic
                                  sticky: true
                                  text: People
                                items:
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-33838201
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjozMzgzODIwMQ==
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: false
                                              can_media_tag: true
                                              created_at: Tue Apr 21 06:59:33 +0000 2009
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                Making AI helpful for everyone. Show
                                                thinking ↓
                                              entities:
                                                description:
                                                  urls: []
                                                url:
                                                  urls:
                                                    - display_url: ai.google
                                                      expanded_url: https://ai.google
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/Bz9VfUNifq
                                              fast_followers_count: 0
                                              favourites_count: 1105
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 2354564
                                              following: false
                                              friends_count: 29
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 27645
                                              location: Mountain View, CA
                                              media_count: 1350
                                              muting: false
                                              name: Google AI
                                              normal_followers_count: 2354564
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '2028873512203489483'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/33838201/1747684575
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1924554705503715328/0-HDhohz_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: GoogleAI
                                              statuses_count: 3190
                                              translator_type: none
                                              url: https://t.co/Bz9VfUNifq
                                              verified: false
                                              verified_type: Business
                                              want_retweets: false
                                              withheld_in_countries: []
                                            profile_image_shape: Square
                                            rest_id: '33838201'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1622943797419155457
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxNjIyOTQzNzk3NDE5MTU1NDU3
                                            is_blue_verified: false
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: true
                                              can_media_tag: true
                                              created_at: Tue Feb 07 13:02:39 +0000 2023
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                $LAI is a Layer-2 blockchain that powers
                                                the AI economy.


                                                #AI2Earn


                                                Chat: https://t.co/zRWRfEqnJi
                                              entities:
                                                description:
                                                  urls:
                                                    - display_url: t.me/LayerAI_org
                                                      expanded_url: http://t.me/LayerAI_org
                                                      indices:
                                                        - 74
                                                        - 97
                                                      url: https://t.co/zRWRfEqnJi
                                                url:
                                                  urls:
                                                    - display_url: layerai.org
                                                      expanded_url: https://layerai.org/
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/5D5Ykqrfos
                                              fast_followers_count: 0
                                              favourites_count: 779
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 223195
                                              following: false
                                              friends_count: 29
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 424
                                              location: ''
                                              media_count: 424
                                              muting: false
                                              name: LayerAI | AI2Earn
                                              normal_followers_count: 223195
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '1940805182578676092'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1622943797419155457/1701374633
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1624905957846274055/TIN9IZEA_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: LayerAIorg
                                              statuses_count: 732
                                              translator_type: none
                                              url: https://t.co/5D5Ykqrfos
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            profile_image_shape: Circle
                                            rest_id: '1622943797419155457'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1726913223885029376
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxNzI2OTEzMjIzODg1MDI5Mzc2
                                            is_blue_verified: false
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: true
                                              can_media_tag: true
                                              created_at: Tue Nov 21 10:39:58 +0000 2023
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                The most advanced AI upscaler &
                                                enhancer. Magnific can hallucinate and
                                                reimagine as many details as you wish
                                                (or none) guided by your own prompt and
                                                parameters!
                                              entities:
                                                description:
                                                  urls: []
                                                url:
                                                  urls:
                                                    - display_url: magnific.ai
                                                      expanded_url: https://magnific.ai
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/tKQorD2P4D
                                              fast_followers_count: 0
                                              favourites_count: 1934
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 53840
                                              following: false
                                              friends_count: 4
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 675
                                              location: ''
                                              media_count: 118
                                              muting: false
                                              name: Magnific.ai
                                              normal_followers_count: 53840
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '1947706526929719416'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1726913223885029376/1700568182
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1726914935215529984/pNbqMvUP_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: Magnific_AI
                                              statuses_count: 1303
                                              translator_type: none
                                              url: https://t.co/tKQorD2P4D
                                              verified: false
                                              verified_type: Business
                                              want_retweets: false
                                              withheld_in_countries: []
                                            profile_image_shape: Square
                                            rest_id: '1726913223885029376'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-175314969
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxNzUzMTQ5Njk=
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: false
                                              can_media_tag: false
                                              created_at: Fri Aug 06 07:40:50 +0000 2010
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                “We make war so that we may live in
                                                peace - Aristotle” Only for morons 😅 -
                                                "Retweets and reposts are not
                                                endorsements"
                                              entities:
                                                description:
                                                  urls: []
                                              fast_followers_count: 0
                                              favourites_count: 467
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 1012
                                              following: false
                                              friends_count: 125
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 1
                                              location: Siberia
                                              media_count: 64
                                              muting: false
                                              name: ai
                                              normal_followers_count: 1012
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '2029224870081335382'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/175314969/1640726559
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/2029031615159255043/8dnSgjf__normal.jpg
                                              profile_interstitial_type: ''
                                              protected: true
                                              screen_name: CamelotOfAfrica
                                              statuses_count: 762
                                              translator_type: none
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            professional:
                                              category:
                                                - icon_name: ''
                                                  id: 1049
                                                  name: Data scientist
                                              professional_type: Creator
                                              rest_id: '1468430062555115521'
                                            profile_image_shape: Circle
                                            rest_id: '175314969'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings:
                                              is_enabled: true
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1315312160382291968
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxMzE1MzEyMTYwMzgyMjkxOTY4
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: true
                                              can_media_tag: true
                                              created_at: Sun Oct 11 15:24:04 +0000 2020
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                my spicy page is only $3 rn 🌶️ ;)
                                                backup: @airikaca
                                              entities:
                                                description:
                                                  urls: []
                                                url:
                                                  urls:
                                                    - display_url: onlyfans.com/airikacal/c5
                                                      expanded_url: http://onlyfans.com/airikacal/c5
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/S6KwwyFuu0
                                              fast_followers_count: 0
                                              favourites_count: 320
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 655893
                                              following: false
                                              friends_count: 26
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 655
                                              location: LA
                                              media_count: 45
                                              muting: false
                                              name: airikacal
                                              normal_followers_count: 655893
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '1896164392703873374'
                                              possibly_sensitive: false
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1963986432487292928/JmI19fYi_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: airikacal
                                              statuses_count: 46
                                              translator_type: none
                                              url: https://t.co/S6KwwyFuu0
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            professional:
                                              category:
                                                - icon_name: ''
                                                  id: 934
                                                  name: Social Media Influencer
                                              professional_type: Business
                                              rest_id: '1604249592354127872'
                                            profile_image_shape: Circle
                                            rest_id: '1315312160382291968'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1157283331509235713
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxMTU3MjgzMzMxNTA5MjM1NzEz
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: true
                                              can_media_tag: true
                                              created_at: Fri Aug 02 13:33:42 +0000 2019
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                The AI omnicloud PyTorch developers
                                                love. Made the first AI Studio & PyTorch
                                                Lightning. Get help:
                                                https://t.co/a69wnEBpKH
                                              entities:
                                                description:
                                                  urls:
                                                    - display_url: discord.com/invite/MWAEvnC…
                                                      expanded_url: https://discord.com/invite/MWAEvnC5fU
                                                      indices:
                                                        - 98
                                                        - 121
                                                      url: https://t.co/a69wnEBpKH
                                                url:
                                                  urls:
                                                    - display_url: lightning.ai
                                                      expanded_url: http://lightning.ai
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/hXSE3ZhzKN
                                              fast_followers_count: 0
                                              favourites_count: 3642
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 46421
                                              following: false
                                              friends_count: 89
                                              has_custom_timelines: true
                                              is_translator: false
                                              listed_count: 1128
                                              location: New York, NY
                                              media_count: 1401
                                              muting: false
                                              name: Lightning AI ⚡️
                                              normal_followers_count: 46421
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '1885783429238894630'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1157283331509235713/1759422406
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1734973544985919489/1ni2KrpZ_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: LightningAI
                                              statuses_count: 4781
                                              translator_type: none
                                              url: https://t.co/hXSE3ZhzKN
                                              verified: false
                                              verified_type: Business
                                              want_retweets: false
                                              withheld_in_countries: []
                                            professional:
                                              category:
                                                - icon_name: ''
                                                  id: 713
                                                  name: Science & Technology
                                              professional_type: Business
                                              rest_id: '1561731328961155072'
                                            profile_image_shape: Square
                                            rest_id: '1157283331509235713'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1455697568499781633
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxNDU1Njk3NTY4NDk5NzgxNjMz
                                            is_blue_verified: false
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: true
                                              can_media_tag: true
                                              created_at: Wed Nov 03 00:45:36 +0000 2021
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                $MTOS | No.4 Dapp & No.1 Game on Solana

                                                Leading Global Kiwi #MEME Culture 🥝

                                                AI Agents with Crypto Wallets & Humans
                                                Building Future Game

                                                Since 2021

                                                #AIGaming
                                              entities:
                                                description:
                                                  urls: []
                                                url:
                                                  urls:
                                                    - display_url: link3.to/metaoasis
                                                      expanded_url: http://link3.to/metaoasis
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/0NqqjyB5H2
                                              fast_followers_count: 0
                                              favourites_count: 1167
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 457125
                                              following: false
                                              friends_count: 186
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 193
                                              location: Formerly MetaOasis
                                              media_count: 540
                                              muting: false
                                              name: MomoAI☮️🥝
                                              normal_followers_count: 457125
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '1874044001005060508'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1455697568499781633/1735358048
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1873567408830771200/pRsrIs36_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: Metaoasis_
                                              statuses_count: 1118
                                              translator_type: none
                                              url: https://t.co/0NqqjyB5H2
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            profile_image_shape: Circle
                                            rest_id: '1455697568499781633'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1753744475464052736
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxNzUzNzQ0NDc1NDY0MDUyNzM2
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: true
                                              can_media_tag: true
                                              created_at: Sat Feb 03 11:37:33 +0000 2024
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                Largest AI infra on SUI/BSC/BTC. Deploy
                                                autonomous AI Agents with identity,
                                                continuity & consensus. Make AI smarter.
                                              entities:
                                                description:
                                                  urls: []
                                                url:
                                                  urls:
                                                    - display_url: link3.to/deagentai
                                                      expanded_url: https://link3.to/deagentai
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/DVNDAkk5PS
                                              fast_followers_count: 0
                                              favourites_count: 6788
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 280812
                                              following: false
                                              friends_count: 126
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 143
                                              location: DA's Home 👉
                                              media_count: 304
                                              muting: false
                                              name: DeAgentAI
                                              normal_followers_count: 280812
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '2030486052394480118'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1753744475464052736/1745896115
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/2007338834913267712/-X2NX6w5_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: DeAgentAI
                                              statuses_count: 1764
                                              translator_type: none
                                              url: https://t.co/DVNDAkk5PS
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            professional:
                                              category:
                                                - icon_name: ''
                                                  id: 713
                                                  name: Science & Technology
                                              professional_type: Business
                                              rest_id: '1843934150866415638'
                                            profile_image_shape: Circle
                                            rest_id: '1753744475464052736'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1831598136
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label: {}
                                            has_graduated_access: true
                                            id: VXNlcjoxODMxNTk4MTM2
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: false
                                              can_media_tag: true
                                              created_at: Sun Sep 08 16:48:56 +0000 2013
                                              default_profile: false
                                              default_profile_image: false
                                              description: >-
                                                Aussie single mama living in the woods
                                                🌲
                                              entities:
                                                description:
                                                  urls: []
                                                url:
                                                  urls:
                                                    - display_url: onlyfans.com/vickyaisha/tri…
                                                      expanded_url: >-
                                                        https://onlyfans.com/vickyaisha/trial/90v0iidh1f2nyfbh9kr0jizqxjge6qeg
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/RSUTFPOZ1r
                                              fast_followers_count: 0
                                              favourites_count: 1694
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 1160468
                                              following: false
                                              friends_count: 69
                                              has_custom_timelines: true
                                              is_translator: false
                                              listed_count: 1324
                                              location: It’s FREE 👉🏼
                                              media_count: 565
                                              muting: false
                                              name: Vicky Aisha 🤠
                                              normal_followers_count: 1160468
                                              notifications: false
                                              pinned_tweet_ids_str:
                                                - '1977377148701696208'
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1831598136/1761433254
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1969400164545937413/sB4AQcaS_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: Vicky_Aisha_
                                              statuses_count: 1304
                                              translator_type: none
                                              url: https://t.co/RSUTFPOZ1r
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            profile_image_shape: Circle
                                            rest_id: '1831598136'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                                  - entryId: >-
                                      toptabsrpusermodule-2031096512020217856-user-1621579092775604225
                                    item:
                                      clientEventInfo:
                                        component: user_module
                                        details:
                                          timelinesDetails:
                                            controllerData: >-
                                              DAACDAAFDAABDAACCgABAAAAAAAAAAEKAAKOBopcJjuqsgsAAwAAAAJBSQoABXj5Z+mJk4zvCAAGAAAAAQoAB6LJR672f5e4AAAAAAA=
                                        element: user
                                      itemContent:
                                        __typename: TimelineUser
                                        itemType: TimelineUser
                                        userDisplayType: UserDetailed
                                        user_results:
                                          result:
                                            __typename: User
                                            affiliates_highlighted_label:
                                              label:
                                                badge:
                                                  url: >-
                                                    https://pbs.twimg.com/profile_images/1372643278378663940/fV2U3iEi_bigger.jpg
                                                description: UwU Market
                                                url:
                                                  url: https://twitter.com/shopuwumarket
                                                  urlType: DeepLink
                                                userLabelDisplayType: Badge
                                                userLabelType: BusinessLabel
                                            has_graduated_access: true
                                            id: VXNlcjoxNjIxNTc5MDkyNzc1NjA0MjI1
                                            is_blue_verified: true
                                            legacy:
                                              blocked_by: false
                                              blocking: false
                                              can_dm: false
                                              can_media_tag: true
                                              created_at: Fri Feb 03 18:39:23 +0000 2023
                                              default_profile: true
                                              default_profile_image: false
                                              description: >-
                                                AI VTuber at https://t.co/BZQBABqZVP |
                                                Fan art #Heartheartart

                                                Created by @Vedal987 | Model art @annytf
                                                | All tweets made by Neuro-sama
                                              entities:
                                                description:
                                                  urls:
                                                    - display_url: twitch.tv/vedal987
                                                      expanded_url: http://twitch.tv/vedal987
                                                      indices:
                                                        - 13
                                                        - 36
                                                      url: https://t.co/BZQBABqZVP
                                                url:
                                                  urls:
                                                    - display_url: vedal.ai
                                                      expanded_url: https://vedal.ai/
                                                      indices:
                                                        - 0
                                                        - 23
                                                      url: https://t.co/UND0IvwPX5
                                              fast_followers_count: 0
                                              favourites_count: 0
                                              follow_request_sent: false
                                              followed_by: false
                                              followers_count: 247164
                                              following: false
                                              friends_count: 2
                                              has_custom_timelines: false
                                              is_translator: false
                                              listed_count: 352
                                              location: '@Vedal987''s Computer'
                                              media_count: 24
                                              muting: false
                                              name: Neuro-sama 💜
                                              normal_followers_count: 247164
                                              notifications: false
                                              pinned_tweet_ids_str: []
                                              possibly_sensitive: false
                                              profile_banner_url: >-
                                                https://pbs.twimg.com/profile_banners/1621579092775604225/1746299075
                                              profile_image_url_https: >-
                                                https://pbs.twimg.com/profile_images/1918744443168886784/F9P2MtSE_normal.jpg
                                              profile_interstitial_type: ''
                                              protected: false
                                              screen_name: NeurosamaAI
                                              statuses_count: 445
                                              translator_type: none
                                              url: https://t.co/UND0IvwPX5
                                              verified: false
                                              want_retweets: false
                                              withheld_in_countries: []
                                            profile_image_shape: Circle
                                            rest_id: '1621579092775604225'
                                            super_follow_eligible: false
                                            super_followed_by: false
                                            super_following: false
                                            tipjar_settings: {}
                              entryId: toptabsrpusermodule-2031096512020217856
                              sortIndex: '2031096512020217856'
                          type: TimelineAddEntries
                      responseObjects:
                        feedbackActions:
                          - key: '-2134788070'
                            value:
                              childKeys:
                                - '269351462'
                                - '-1399782652'
                              clientEventInfo:
                                action: click
                                component: result
                                element: feedback_givefeedback
                              confirmation: >-
                                Thanks for offering your feedback. X is
                                conducting research to improve search. Choose
                                the option that best reflects your opinion.
                              confirmationDisplayType: Inline
                              feedbackType: GiveFeedback
                              hasUndoAction: true
                              icon: Frown
                              prompt: This post's not helpful
                          - key: '269351462'
                            value:
                              clientEventInfo:
                                action: click
                                component: result
                                element: feedback_notrelevant
                              confirmation: >-
                                Thanks for your help.

                                This feedback will be used in research to
                                improve the search function.
                              confirmationDisplayType: Inline
                              feedbackType: NotRelevant
                              hasUndoAction: true
                              prompt: This post isn't relevant
                          - key: '-1399782652'
                            value:
                              clientEventInfo:
                                action: click
                                component: result
                                element: feedback_notcredible
                              confirmation: >-
                                Thanks for your help.

                                This feedback will be used in research to
                                improve the search function.
                              confirmationDisplayType: Inline
                              feedbackType: NotCredible
                              hasUndoAction: true
                              prompt: This post isn't credible
                credits_used: 1
                endpoint: twitter/search
        '400':
          description: Bad Request - Invalid parameters or missing required fields
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: query is required
                  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
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Failed to search Twitter
                  endpoint:
                    type: string
                    example: search
                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).

````