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

# समाचार खोजें

> निर्दिष्ट खोज क्वेरी से मेल खाने वाली समाचार स्टोरीज़ की सूची प्राप्त करता है।



## OpenAPI

````yaml /hi/openapi.json GET /2/news/search
openapi: 3.0.0
info:
  description: X API v2 के उपलब्ध एंडपॉइंट्स
  version: '2.157'
  title: X API v2
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
  - description: X API
    url: https://api.x.com
security: []
tags:
  - name: Account Activity
    description: AAA सदस्यताओं को प्राप्त करने और प्रबंधित करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: >-
        https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  - name: Bookmarks
    description: >-
      किसी उपयोगकर्ता के बुकमार्क प्राप्त करने और प्रबंधित करने से संबंधित
      एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/bookmarks
  - name: Compliance
    description: आपके सिस्टम में X डेटा को अनुपालक बनाए रखने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: >-
        https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction
  - name: Connections
    description: स्ट्रीमिंग कनेक्शनों से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.x.com/en/docs/x-api/connections
  - name: Direct Messages
    description: Direct Messages को प्राप्त करने और प्रबंधित करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/direct-messages
  - name: General
    description: सामान्य API कार्यक्षमता के लिए विविध एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api
  - name: Lists
    description: सूचियों को प्राप्त करने और प्रबंधित करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/lists
  - name: Media
    description: Media से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.x.com
  - name: MediaUpload
    description: Media अपलोड करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.x.com
  - name: News
    description: समाचार स्टोरीज़ प्राप्त करने के लिए एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/news
  - name: Spaces
    description: Spaces को प्राप्त करने और प्रबंधित करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/spaces
  - name: Stream
    description: स्ट्रीमिंग से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.x.com
  - name: Tweets
    description: Tweets को प्राप्त करने, खोजने और संशोधित करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/tweets/lookup
  - name: Users
    description: Users के संबंधों को प्राप्त करने और प्रबंधित करने से संबंधित एंडपॉइंट
    externalDocs:
      description: और जानें
      url: https://developer.twitter.com/en/docs/twitter-api/users/lookup
paths:
  /2/news/search:
    get:
      tags:
        - News
      summary: समाचार खोजें
      description: >-
        निर्दिष्ट खोज क्वेरी से मेल खाने वाली समाचार स्टोरीज़ की सूची प्राप्त
        करता है।
      operationId: searchNews
      parameters:
        - name: query
          in: query
          description: खोज क्वेरी।
          required: true
          example: crypto
          schema:
            type: string
            minLength: 1
            maxLength: 2048
            example: crypto
          style: form
        - name: max_results
          in: query
          description: लौटाए जाने वाले परिणामों की संख्या।
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            format: int32
            default: 10
          style: form
        - name: max_age_hours
          in: query
          description: खोजे जाने वाले समाचार लेख की अधिकतम आयु।
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 720
            format: int32
            default: 168
          style: form
        - $ref: '#/components/parameters/NewsFieldsParameter'
      responses:
        '200':
          description: अनुरोध सफल रहा है।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2NewsSearchResponse'
        default:
          description: अनुरोध विफल रहा है।
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - BearerToken: []
        - OAuth2UserToken:
            - tweet.read
            - users.read
      externalDocs:
        url: https://docs.x.com/x-api/news/introduction
components:
  parameters:
    NewsFieldsParameter:
      name: news.fields
      in: query
      description: प्रदर्शित करने के लिए समाचार फ़ील्ड्स की अल्पविराम-से-अलग सूची।
      required: false
      schema:
        type: array
        description: समाचार ऑब्जेक्ट के लिए उपलब्ध फ़ील्ड्स।
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
            - category
            - cluster_posts_results
            - contexts
            - disclaimer
            - hook
            - id
            - keywords
            - name
            - summary
            - updated_at
        example:
          - category
          - cluster_posts_results
          - contexts
          - disclaimer
          - hook
          - id
          - keywords
          - name
          - summary
          - updated_at
      explode: false
      style: form
  schemas:
    Get2NewsSearchResponse:
      type: object
      properties:
        data:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/News'
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
        meta:
          type: object
          properties:
            result_count:
              $ref: '#/components/schemas/ResultCount'
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    Problem:
      type: object
      description: >-
        IETF RFC 7807 (https://tools.ietf.org/html/rfc7807) में परिभाषित एक HTTP
        Problem Details ऑब्जेक्ट।
      required:
        - type
        - title
      properties:
        detail:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          type: string
      discriminator:
        propertyName: type
        mapping:
          about:blank:
            $ref: '#/components/schemas/GenericProblem'
          https://api.twitter.com/2/problems/client-disconnected:
            $ref: '#/components/schemas/ClientDisconnectedProblem'
          https://api.twitter.com/2/problems/client-forbidden:
            $ref: '#/components/schemas/ClientForbiddenProblem'
          https://api.twitter.com/2/problems/conflict:
            $ref: '#/components/schemas/ConflictProblem'
          https://api.twitter.com/2/problems/disallowed-resource:
            $ref: '#/components/schemas/DisallowedResourceProblem'
          https://api.twitter.com/2/problems/duplicate-rules:
            $ref: '#/components/schemas/DuplicateRuleProblem'
          https://api.twitter.com/2/problems/invalid-request:
            $ref: '#/components/schemas/InvalidRequestProblem'
          https://api.twitter.com/2/problems/invalid-rules:
            $ref: '#/components/schemas/InvalidRuleProblem'
          https://api.twitter.com/2/problems/noncompliant-rules:
            $ref: '#/components/schemas/NonCompliantRulesProblem'
          https://api.twitter.com/2/problems/not-authorized-for-field:
            $ref: '#/components/schemas/FieldUnauthorizedProblem'
          https://api.twitter.com/2/problems/not-authorized-for-resource:
            $ref: '#/components/schemas/ResourceUnauthorizedProblem'
          https://api.twitter.com/2/problems/operational-disconnect:
            $ref: '#/components/schemas/OperationalDisconnectProblem'
          https://api.twitter.com/2/problems/resource-not-found:
            $ref: '#/components/schemas/ResourceNotFoundProblem'
          https://api.twitter.com/2/problems/resource-unavailable:
            $ref: '#/components/schemas/ResourceUnavailableProblem'
          https://api.twitter.com/2/problems/rule-cap:
            $ref: '#/components/schemas/RulesCapProblem'
          https://api.twitter.com/2/problems/streaming-connection:
            $ref: '#/components/schemas/ConnectionExceptionProblem'
          https://api.twitter.com/2/problems/unsupported-authentication:
            $ref: '#/components/schemas/UnsupportedAuthenticationProblem'
          https://api.twitter.com/2/problems/usage-capped:
            $ref: '#/components/schemas/UsageCapExceededProblem'
    News:
      type: object
      description: AI द्वारा जनरेट की गई समाचार स्टोरी।
      required:
        - rest_id
      properties:
        category:
          type: string
          description: समाचार श्रेणी।
        cluster_posts_results:
          type: array
          items:
            type: object
            properties:
              post_id:
                $ref: '#/components/schemas/TweetId'
        contexts:
          type: object
          properties:
            entities:
              type: object
              properties:
                events:
                  type: array
                  items:
                    type: string
                organizations:
                  type: array
                  items:
                    type: string
                people:
                  type: array
                  items:
                    type: string
                places:
                  type: array
                  items:
                    type: string
                products:
                  type: array
                  items:
                    type: string
            finance:
              type: object
              properties:
                tickers:
                  type: array
                  items:
                    type: string
            sports:
              type: object
              properties:
                teams:
                  type: array
                  items:
                    type: string
            topics:
              type: array
              items:
                type: string
        disclaimer:
          type: string
        hook:
          type: string
          description: समाचार हुक।
        keywords:
          type: array
          items:
            type: string
        last_updated_at_ms:
          type: string
          format: date-time
          example: '2025-7-14T04:35:55Z'
        name:
          type: string
          description: हेडलाइन।
        rest_id:
          $ref: '#/components/schemas/NewsId'
        summary:
          type: string
          description: समाचार सारांश।
    ResultCount:
      type: integer
      description: इस रिस्पॉन्स में लौटाए गए परिणामों की संख्या।
      format: int32
    GenericProblem:
      description: >-
        एक सामान्य समस्या, जिसमें HTTP स्टेटस कोड द्वारा दी गई जानकारी के
        अतिरिक्त कोई और जानकारी नहीं होती।
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientDisconnectedProblem:
      description: आपका क्लाइंट डिस्कनेक्ट हो गया है।
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientForbiddenProblem:
      description: >-
        ऐसी समस्या जो दर्शाती है कि आपका क्लाइंट यह अनुरोध करने के लिए अधिकृत
        नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            reason:
              type: string
              enum:
                - official-client-forbidden
                - client-not-enrolled
            registration_url:
              type: string
              format: uri
    ConflictProblem:
      description: यदि एक जॉब पहले से प्रगति में है, तो आप नई जॉब नहीं बना सकते।
      allOf:
        - $ref: '#/components/schemas/Problem'
    DisallowedResourceProblem:
      description: >-
        एक Problem जो दर्शाता है कि अनुरोधित resource इस API के सिद्धांतों का
        उल्लंघन करता है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_id
            - resource_type
            - section
          properties:
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    DuplicateRuleProblem:
      description: आपके द्वारा सबमिट किया गया नियम डुप्लिकेट है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            id:
              type: string
            value:
              type: string
    InvalidRequestProblem:
      description: ऐसी समस्या, जो बताती है कि यह अनुरोध अमान्य है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            errors:
              type: array
              minItems: 1
              items:
                type: object
                properties:
                  message:
                    type: string
                  parameters:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
    InvalidRuleProblem:
      description: आपके द्वारा सबमिट किया गया नियम अमान्य है।
      allOf:
        - $ref: '#/components/schemas/Problem'
    NonCompliantRulesProblem:
      description: ऐसी समस्या जो दर्शाती है कि यूज़र का नियम-समूह अनुपालन में नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
    FieldUnauthorizedProblem:
      description: >-
        ऐसी समस्या जो यह दर्शाती है कि आपको Tweet, उपयोगकर्ता आदि पर किसी विशेष
        फ़ील्ड को देखने की अनुमति नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_type
            - field
            - section
          properties:
            field:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    ResourceUnauthorizedProblem:
      description: >-
        ऐसी Problem जो दर्शाती है कि आपको किसी विशेष Tweet, User आदि को देखने की
        अनुमति नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - value
            - resource_id
            - resource_type
            - section
            - parameter
          properties:
            parameter:
              type: string
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
            value:
              type: string
    OperationalDisconnectProblem:
      description: परिचालन कारणों से आपका कनेक्शन डिस्कनेक्ट कर दिया गया है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            disconnect_type:
              type: string
              enum:
                - OperationalDisconnect
                - UpstreamOperationalDisconnect
                - ForceDisconnect
                - UpstreamUncleanDisconnect
                - SlowReader
                - InternalError
                - ClientApplicationStateDegraded
                - InvalidRules
    ResourceNotFoundProblem:
      description: ऐसी Problem जो दर्शाती है कि दिया गया Tweet, User आदि मौजूद नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - value
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            value:
              type: string
              description: मान फ़ील्ड के स्कीमा से मेल खाएगा।
    ResourceUnavailableProblem:
      description: >-
        ऐसी Problem जो दर्शाती है कि कोई विशेष Tweet, User आदि आपके लिए उपलब्ध
        नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
    RulesCapProblem:
      description: आप rules की अधिकतम संख्या से अधिक हो गए हैं।
      allOf:
        - $ref: '#/components/schemas/Problem'
    ConnectionExceptionProblem:
      description: एक Problem जो दर्शाता है कि कनेक्शन में कुछ गड़बड़ी है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            connection_issue:
              type: string
              enum:
                - TooManyConnections
                - ProvisioningSubscription
                - RuleConfigurationIssue
                - RulesInvalidIssue
    UnsupportedAuthenticationProblem:
      description: ऐसी समस्या जो दर्शाती है कि उपयोग किया गया प्रमाणीकरण समर्थित नहीं है।
      allOf:
        - $ref: '#/components/schemas/Problem'
    UsageCapExceededProblem:
      description: ऐसी समस्या जो दर्शाती है कि उपयोग सीमा पार हो गई है।
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            period:
              type: string
              enum:
                - Daily
                - Monthly
            scope:
              type: string
              enum:
                - Account
                - Product
    TweetId:
      type: string
      description: >-
        इस Tweet का विशिष्ट पहचानकर्ता। इसे स्ट्रिंग के रूप में लौटाया जाता है,
        ताकि उन भाषाओं और टूल्स में जटिलताओं से बचा जा सके जो बड़े पूर्णांकों को
        संभाल नहीं सकते।
      pattern: ^[0-9]{1,19}$
      example: '1346889436626259968'
    NewsId:
      type: string
      description: समाचार स्टोरी का विशिष्ट पहचानकर्ता।
      pattern: ^[0-9]{1,19}$
      example: '2244994945'
  securitySchemes:
    BearerToken:
      type: http
      scheme: bearer
    OAuth2UserToken:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://api.x.com/2/oauth2/authorize
          tokenUrl: https://api.x.com/2/oauth2/token
          scopes:
            block.read: View accounts you have blocked.
            bookmark.read: Read your bookmarked Posts.
            bookmark.write: Create and delete your bookmarks.
            dm.read: Read all your Direct Messages.
            dm.write: Send and manage your Direct Messages.
            follows.read: View accounts you follow and accounts following you.
            follows.write: Follow and unfollow accounts on your behalf.
            like.read: View Posts you have liked and likes you can see.
            like.write: Like and unlike Posts on your behalf.
            list.read: >-
              View Lists, members, and followers of Lists you created or are a
              member of, including private Lists.
            list.write: Create and manage Lists on your behalf.
            media.write: Upload media, such as photos and videos, on your behalf.
            mute.read: View accounts you have muted.
            mute.write: Mute and unmute accounts on your behalf.
            offline.access: Request a refresh token for the app.
            space.read: View all Spaces you have access to.
            timeline.read: >-
              View all Custom Timelines you can see, including public Custom
              Timelines from other developers.
            tweet.moderate.write: Hide and unhide replies to your Posts.
            tweet.read: >-
              View all Posts you can see, including those from protected
              accounts.
            tweet.write: Post and repost on your behalf.
            users.read: View any account you can see, including protected accounts.

````