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

# Search

> This endpoint return search results



## OpenAPI

````yaml /openapi/x.openapi.json post /v1/data/x/search/search
openapi: 3.0.0
info:
  title: agntdata X (Twitter) API
  description: >-
    Introducing "The Old Bird" API, a robust Twitter API designed to unlock
    valuable Twitter data effortlessly. With this API, you can access tweet
    details, user followers, followings, post engagements, and more. Explore
    top, latest, videos, photos, and people through our comprehensive search
    functionality. Retrieve user-specific information, including tweets,
    replies, media, likes, and profile details by username or ID.
  version: 1.0.0
  contact:
    name: agntdata
    url: https://agntdata.dev
servers:
  - url: https://api.agntdata.dev
    description: agntdata API
security:
  - ApiKeyAuth: []
tags:
  - name: User
    description: ''
  - name: Search
    description: ''
  - name: Hashtag
    description: ''
  - name: Tweet
    description: ''
  - name: Lists
    description: ''
  - name: Trends
    description: ''
  - name: Translation
    description: Translate Service
  - name: AI
    description: A set of AI related services
paths:
  /v1/data/x/search/search:
    post:
      tags:
        - Search
      summary: Search
      description: This endpoint return search results
      operationId: Search_post__search_search
      parameters: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                limit:
                  type: integer
                section:
                  type: string
                language:
                  type: string
                min_likes:
                  type: integer
                min_retweets:
                  type: integer
                start_date:
                  type: string
            example:
              query: '#python'
              limit: 5
              section: top
              language: en
              min_likes: 20
              min_retweets: 20
              start_date: '2022-01-01'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Post_x_search_search_Response'
              example:
                results:
                  - tweet_id: '1522312701137018881'
                    creation_date: Thu May 05 20:30:05 +0000 2022
                    text: >-
                      🐍 Learn how to send emails using Python —
                      https://t.co/dZgXrnB1LK 

                      #python https://t.co/UveP8fxjKc
                    media_url: null
                    user:
                      creation_date: Wed Aug 08 20:44:42 +0000 2012
                      user_id: '745911914'
                      username: realpython
                      name: Real Python
                      follower_count: 140866
                      following_count: 166
                      is_private: false
                      is_verified: false
                      location: ''
                      profile_pic_url: >-
                        https://pbs.twimg.com/profile_images/1230295831560896512/C72hyNCj_normal.jpg
                      description: >-
                        Online #Python Training & Expert Community: Tutorials,
                        Video Courses, Books, Quizzes...and More! Join 3,000,000
                        Monthly Readers at https://t.co/TyrG6Kkaq6
                      external_url: http://realpython.com
                      number_of_tweets: 56616
                      bot: false
                      timestamp: 1344458682
                    language: en
                    favorite_count: 425
                    retweet_count: 97
                    reply_count: 5
                    quote_count: 4
                    retweet: false
                    timestamp: 1651782605
                  - tweet_id: '1520848051476176896'
                    creation_date: Sun May 01 19:30:06 +0000 2022
                    text: >-
                      PYTHON BASICS IN ONE IMAGE🔴🔵

                      A China-based developer Yusheng has created this brilliant
                      image. #100DaysOfCode #Python #programming #Coding
                      https://t.co/Qa4OhYRJyC
                    media_url: null
                    user:
                      creation_date: Thu Nov 11 18:07:50 +0000 2021
                      user_id: '1458858920043171840'
                      username: Saransh1683
                      name: Saransh Saxena
                      follower_count: 59
                      following_count: 10
                      is_private: false
                      is_verified: false
                      location: India
                      profile_pic_url: >-
                        https://pbs.twimg.com/profile_images/1481272433470423042/pHSks7rq_normal.jpg
                      description: >-
                        ALWAYS READY TO HELP.

                        Animal Lover |

                        Technology Lover | Post about current affairs and Tech
                        Tricks | Save Earth🌏
                      external_url: null
                      number_of_tweets: 212
                      bot: false
                      timestamp: 1636654070
                    language: en
                    favorite_count: 406
                    retweet_count: 173
                    reply_count: 12
                    quote_count: 4
                    retweet: false
                    timestamp: 1651433406
                  - tweet_id: '1521720513525080064'
                    creation_date: Wed May 04 05:16:57 +0000 2022
                    text: >-
                      Me after emotional burnout be like: 


                      #100DaysOfCode #Python #Java #programminghumor #javascript
                      https://t.co/GWmeewxekO
                    media_url: null
                    user:
                      creation_date: Thu Mar 04 20:55:55 +0000 2021
                      user_id: '1367579422086357005'
                      username: TinaKan11
                      name: Tina Kan
                      follower_count: 36
                      following_count: 24
                      is_private: false
                      is_verified: false
                      location: ''
                      profile_pic_url: >-
                        https://pbs.twimg.com/profile_images/1377138058378706944/tzsYaoLT_normal.jpg
                      description: |-
                        Scorpio ♏
                        Backend developer 👩‍💻 
                        Write about Java☕, Python🐍 and backend development. 
                        Try to tweet something interesting every day. 😉
                      external_url: https://github.com/iturkan6
                      number_of_tweets: 143
                      bot: false
                      timestamp: 1614891355
                    language: en
                    favorite_count: 195
                    retweet_count: 85
                    reply_count: 10
                    quote_count: 3
                    retweet: false
                    timestamp: 1651641417
                  - tweet_id: '1522352943734956033'
                    creation_date: Thu May 05 23:10:00 +0000 2022
                    text: |-
                      💥 A list of python libraries &amp; frameworks!
                      Source: @AfricaDataSch

                      #Python #Framework #Libraries https://t.co/q6pSbrfVGS
                    media_url: null
                    user:
                      creation_date: Sun Mar 31 19:25:57 +0000 2013
                      user_id: '1318985240'
                      username: DataScienceDojo
                      name: Data Science Dojo
                      follower_count: 53328
                      following_count: 990
                      is_private: false
                      is_verified: false
                      location: Seattle, WA
                      profile_pic_url: >-
                        https://pbs.twimg.com/profile_images/1522623516868321283/TtXH9cC2_normal.jpg
                      description: >-
                        Disrupting the data science education space by offering
                        unique and dynamic courses for individuals and
                        organizations.

                        #DSDojo
                      external_url: https://datasciencedojo.com/
                      number_of_tweets: 29707
                      bot: false
                      timestamp: 1364757957
                    language: en
                    favorite_count: 1318
                    retweet_count: 365
                    reply_count: 7
                    quote_count: 5
                    retweet: false
                    timestamp: 1651792200
                  - tweet_id: '1522608710459273218'
                    creation_date: Fri May 06 16:06:19 +0000 2022
                    text: >-
                      success blueprint 👌

                      #AI #DataScience #databases #ArtificialIntelligence
                      #python #DeepLearning https://t.co/KcgiqP3wF4
                    media_url: null
                    user:
                      creation_date: Wed Apr 06 17:11:07 +0000 2022
                      user_id: '1511753322948141057'
                      username: mo_ournani
                      name: Mohamed ournani
                      follower_count: 28
                      following_count: 30
                      is_private: false
                      is_verified: false
                      location: ''
                      profile_pic_url: >-
                        https://pbs.twimg.com/profile_images/1521619056847167490/cbJPsRD9_normal.jpg
                      description: Programming and artificial intelligence 🤖
                      external_url: null
                      number_of_tweets: 18
                      bot: false
                      timestamp: 1649265067
                    language: en
                    favorite_count: 258
                    retweet_count: 94
                    reply_count: 5
                    quote_count: 1
                    retweet: false
                    timestamp: 1651853179
                continuation_token: >-
                  scroll:thGAVUV0VFVBYBFoDg562visKfKhIYPBJjwusAAAH0P4BiTdLxqfwAAAAFFRsjPrmVIAAVIFdWDFZgARUePL6gFmAAFSB778IXoAEVIWSOFtcwAmEViIh6FYCJehgEVVNFUjUKFQAVAAA=
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Post_x_search_search_Response422'
              example:
                detail:
                  - loc: []
                    msg: ''
                    type: ''
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Post_x_search_search_Response:
      type: object
      properties:
        results:
          type: array
          items:
            type: object
            properties:
              tweet_id:
                type: string
              creation_date:
                type: string
              text:
                type: string
              media_url:
                type: string
                nullable: true
              user:
                type: object
              language:
                type: string
              favorite_count:
                type: integer
              retweet_count:
                type: integer
              reply_count:
                type: integer
              quote_count:
                type: integer
              retweet:
                type: boolean
              timestamp:
                type: integer
        continuation_token:
          type: string
    Post_x_search_search_Response422:
      title: HTTPValidationError
      type: object
      properties:
        detail:
          title: Detail
          type: array
          items:
            title: ValidationError
            required:
              - loc
              - msg
              - type
            type: object
            properties:
              loc:
                title: Location
                type: array
                items:
                  anyOf:
                    - type: string
                    - type: integer
              msg:
                title: Message
                type: string
              type:
                title: Error Type
                type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Bearer token. Pass your agntdata API key as: Authorization: Bearer
        agnt_live_...

````