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

# Rechercher des actualités

> Récupère une liste de résultats correspondant à la requête de recherche spécifiée.



## OpenAPI

````yaml /fr/openapi.json GET /2/news/search
openapi: 3.0.0
info:
  description: Points de terminaison disponibles dans 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: >-
      Points de terminaison pour la récupération et la gestion des abonnements
      AAA
    externalDocs:
      description: En savoir plus
      url: >-
        https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  - name: Bookmarks
    description: >-
      Points de terminaison permettant de récupérer et de gérer les signets d’un
      utilisateur
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/bookmarks
  - name: Compliance
    description: >-
      Points de terminaison pour garantir la conformité des données X dans vos
      systèmes
    externalDocs:
      description: En savoir plus
      url: >-
        https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction
  - name: Connections
    description: Points de terminaison pour les connexions de flux en continu
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com/en/docs/x-api/connections
  - name: Direct Messages
    description: >-
      Points de terminaison permettant de récupérer et de gérer les Direct
      Messages
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/direct-messages
  - name: General
    description: Points de terminaison divers pour des fonctionnalités générales de l’API
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api
  - name: Lists
    description: Points de terminaison pour la récupération et la gestion des Listes
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/lists
  - name: Media
    description: Points de terminaison pour les médias
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com
  - name: MediaUpload
    description: Points de terminaison pour le téléversement de médias
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com
  - name: News
    description: Point de terminaison pour récupérer des articles d’actualité
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/news
  - name: Spaces
    description: Points de terminaison pour la récupération et la gestion des Spaces
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/spaces
  - name: Stream
    description: Points de terminaison pour le streaming
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com
  - name: Tweets
    description: >-
      Points de terminaison pour la récupération, la recherche et la
      modification de Tweets
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/tweets/lookup
  - name: Users
    description: >-
      Points de terminaison pour la récupération et la gestion des relations des
      utilisateurs
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/users/lookup
paths:
  /2/news/search:
    get:
      tags:
        - News
      summary: Rechercher des actualités
      description: >-
        Récupère une liste de résultats correspondant à la requête de recherche
        spécifiée.
      operationId: searchNews
      parameters:
        - name: query
          in: query
          description: La requête de recherche.
          required: true
          example: crypto
          schema:
            type: string
            minLength: 1
            maxLength: 2048
            example: crypto
          style: form
        - name: max_results
          in: query
          description: Nombre de résultats à retourner.
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            format: int32
            default: 10
          style: form
        - name: max_age_hours
          in: query
          description: Ancienneté maximale de l’article d’actualité à rechercher.
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 720
            format: int32
            default: 168
          style: form
        - $ref: '#/components/parameters/NewsFieldsParameter'
      responses:
        '200':
          description: La requête a réussi.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Get2NewsSearchResponse'
        default:
          description: La requête a échoué.
          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: Une liste de champs News, séparés par des virgules, à renvoyer.
      required: false
      schema:
        type: array
        description: Les champs disponibles pour l’objet News.
        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: >-
        Un objet HTTP Problem Details, tel que défini dans la RFC IETF 7807
        (https://tools.ietf.org/html/rfc7807).
      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: Une actualité générée par l’IA.
      required:
        - rest_id
      properties:
        category:
          type: string
          description: La catégorie de l’actualité.
        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: Accroche de l'article d'actualité.
        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: Titre.
        rest_id:
          $ref: '#/components/schemas/NewsId'
        summary:
          type: string
          description: Résumé de l'article d'actualité.
    ResultCount:
      type: integer
      description: Nombre de résultats renvoyés dans cette réponse.
      format: int32
    GenericProblem:
      description: >-
        Problème générique ne contenant aucune information supplémentaire
        au-delà de celle fournie par le code d’état HTTP.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientDisconnectedProblem:
      description: Votre client a été déconnecté.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientForbiddenProblem:
      description: >-
        Un problème indiquant que votre client n’est pas autorisé à effectuer
        cette requête.
      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: >-
        Vous ne pouvez pas créer de nouvelle tâche si une tâche est déjà en
        cours.
      allOf:
        - $ref: '#/components/schemas/Problem'
    DisallowedResourceProblem:
      description: >-
        Objet Problem qui indique que la ressource demandée enfreint les
        principes de cette 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: La règle que vous avez soumise est un doublon.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            id:
              type: string
            value:
              type: string
    InvalidRequestProblem:
      description: Un Problem qui indique que cette requête est invalide.
      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: La règle que vous avez soumise est invalide.
      allOf:
        - $ref: '#/components/schemas/Problem'
    NonCompliantRulesProblem:
      description: >-
        Un Problem indiquant que l'ensemble de règles de l'utilisateur n'est pas
        conforme.
      allOf:
        - $ref: '#/components/schemas/Problem'
    FieldUnauthorizedProblem:
      description: >-
        Un problème indiquant que vous n’êtes pas autorisé à voir un champ
        particulier d’un Tweet, d’un utilisateur, etc.
      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: >-
        Un problème indiquant que vous n’êtes pas autorisé à voir un Tweet, un
        utilisateur, etc. donné.
      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: Vous avez été déconnecté pour des raisons opérationnelles.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            disconnect_type:
              type: string
              enum:
                - OperationalDisconnect
                - UpstreamOperationalDisconnect
                - ForceDisconnect
                - UpstreamUncleanDisconnect
                - SlowReader
                - InternalError
                - ClientApplicationStateDegraded
                - InvalidRules
    ResourceNotFoundProblem:
      description: >-
        Un Problem qui indique qu’un Tweet, un utilisateur, etc. donné n’existe
        pas.
      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: La valeur sera conforme au schéma du champ.
    ResourceUnavailableProblem:
      description: >-
        Un problème indiquant qu’un Tweet, un utilisateur, etc. donné n’est pas
        disponible pour vous.
      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: Vous avez dépassé le nombre maximal de règles autorisées.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ConnectionExceptionProblem:
      description: >-
        Un objet Problem indiquant qu’il y a un dysfonctionnement avec la
        connexion.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            connection_issue:
              type: string
              enum:
                - TooManyConnections
                - ProvisioningSubscription
                - RuleConfigurationIssue
                - RulesInvalidIssue
    UnsupportedAuthenticationProblem:
      description: >-
        Un Problem indiquant que le mécanisme d’authentification utilisé n’est
        pas pris en charge.
      allOf:
        - $ref: '#/components/schemas/Problem'
    UsageCapExceededProblem:
      description: Un Problem qui indique qu’un plafond d’utilisation a été dépassé
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            period:
              type: string
              enum:
                - Daily
                - Monthly
            scope:
              type: string
              enum:
                - Account
                - Product
    TweetId:
      type: string
      description: >-
        Identifiant unique de ce Tweet. Il est renvoyé sous forme de chaîne de
        caractères afin d’éviter les complications avec les langages et outils
        qui ne gèrent pas les entiers de très grande taille.
      pattern: ^[0-9]{1,19}$
      example: '1346889436626259968'
    NewsId:
      type: string
      description: Identifiant unique de l'article d'actualité.
      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.

````