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

# Consulter ou lire un article

Consultez les métadonnées d’un article à partir de son identifiant, ou ajoutez un paramètre `query` pour lire les passages de texte intégral les plus pertinents pour une question.

Les identifiants acceptés incluent les valeurs canoniques `paperId` ainsi que les valeurs `primaryId` propres à la source (par ex. `arxiv:1706.03762`).

Pour un aperçu du workflow, consultez le [guide de l’index Research](/fr/features/research).


## OpenAPI

````yaml fr/api-reference/v2-openapi.json GET /search/research/papers/{id}
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API pour interagir avec les services Firecrawl afin d’effectuer des tâches
    de scraping et de crawling web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /search/research/papers/{id}:
    get:
      tags:
        - Research
      summary: Inspecter ou lire un article
      operationId: researchGetPaper
      parameters:
        - description: "Référence de l’article\_: un paperId canonique ou un primaryId spécifique à la source."
          examples:
            paperId:
              summary: paperId canonique
              value: '2014215642691656232'
            sourceId:
              summary: primaryId spécifique à la source
              value: arxiv:2105.05233
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: >-
            Si ce paramètre est présent, renvoie les principaux passages de
            texte intégral correspondant à cette question. Omettez-le pour
            inspecter uniquement les métadonnées.
          in: query
          name: query
          required: false
          schema:
            minLength: 1
            type: string
        - description: >-
            Nombre de passages en mode lecture. Valide uniquement lorsque query
            est présent.
          in: query
          name: k
          required: false
          schema:
            default: 4
            maximum: 50
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              example:
                paper:
                  abstract: >-
                    We show that diffusion models can achieve image sample
                    quality superior to the current state-of-the-art generative
                    models...
                  authors: Prafulla Dhariwal, Alexander Nichol
                  categories:
                    - cs.LG
                  createdDate: Wed, 11 May 2021 18:01:01 GMT
                  ids:
                    arxiv:
                      - '2105.05233'
                  paperId: '2014215642691656232'
                  title: Diffusion Models Beat GANs on Image Synthesis
                  updateDate: '2021-06-01'
                success: true
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ResearchPaperMetadataResponse'
                  - $ref: '#/components/schemas/ResearchReadPaperResponse'
          description: Métadonnées de l’article ou passages en mode lecture.
        '400':
          description: Requête non valide
        '401':
          description: bearer token manquant ou non valide
        '404':
          description: Article introuvable
        '429':
          description: Limite de requêtes dépassée
        '500':
          description: Erreur interne du serveur
      security:
        - bearerAuth: []
components:
  schemas:
    ResearchPaperMetadataResponse:
      properties:
        paper:
          $ref: '#/components/schemas/ResearchPaperMetadata'
        success:
          type: boolean
      required:
        - success
        - paper
      type: object
    ResearchReadPaperResponse:
      properties:
        paper:
          $ref: '#/components/schemas/ResearchPaperMetadata'
        paperId:
          type: string
        passages:
          items:
            $ref: '#/components/schemas/ResearchPassage'
          type: array
        query:
          type: string
        success:
          type: boolean
      required:
        - success
        - paper
        - paperId
        - query
        - passages
      type: object
    ResearchPaperMetadata:
      properties:
        abstract:
          type: string
        authors:
          description: Noms des auteurs séparés par des virgules.
          type: string
        categories:
          description: Catégories de l'article.
          items:
            type: string
          type: array
        createdDate:
          description: Chaîne de date de création d'origine.
          type: string
        ids:
          $ref: '#/components/schemas/ResearchIdMap'
        paperId:
          description: ID canonique de l'article.
          type: string
        title:
          type: string
        updateDate:
          description: Chaîne de date de dernière mise à jour.
          type: string
      required:
        - paperId
        - title
        - abstract
      type: object
    ResearchPassage:
      properties:
        score:
          description: Score de similarité dense pour le passage.
          format: double
          type: number
        text:
          description: >-
            Texte du passage dans le corps de l'article. Peut inclure des
            tableaux markdown.
          type: string
      required:
        - text
        - score
      type: object
    ResearchIdMap:
      additionalProperties:
        items:
          type: string
        type: array
      description: Identifiants source regroupés par espace de noms.
      example:
        arxiv:
          - '2105.05233'
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````