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

# Research API (Legacy)

<Note>
  **Before You Get Started**

  To register for usage of our Research API, please reach out via email at [api@you.com](mailto:api@you.com).
</Note>


## OpenAPI

````yaml openapi_chat POST /research
openapi: 3.0.0
info:
  title: You.com APIs
  description: CHAT WITH THE BEST, CHAT WITH YOU!
  version: 0.0.1
servers:
  - url: https://chat-api.you.com
security:
  - ApiKeyAuth: []
paths:
  /research:
    post:
      summary: >-
        Returns in-depth answers with extensive citations for a variety of
        questions
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: >-
                    The main question or statement to be answered. This input
                    directs the scope and context of the response.
                chat_id:
                  type: string
                  description: >-
                    A hexadecimal `UUID` to maintain continuity within the
                    conversation. This can be a randomly generated string that
                    uniquely identifies the session.
                  format: uuid
      responses:
        '200':
          description: >-
            A JSON object containing a dictionary with the answer and a list of
            search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  answer:
                    type: string
                    description: >-
                      The main response generated by the API based on the
                      provided `query` and `instructions`.
                    example: >-
                      # The Impact of AI on Productivity


                      Artificial Intelligence (AI) is increasingly becoming a
                      pivotal force in enhancing productivity across various
                      sectors. 
                  search_results:
                    type: array
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: The URL of the specific search result.
                          example: >-
                            https://www.goldmansachs.com/insights/articles/AI-is-showing-very-positive-signs-of-boosting-gdp#:~:text=concerns%20about%20privacy%20and,of%20the%20technology%20as
                        name:
                          type: string
                          description: The title or name of the search result.
                          example: >-
                            AI is showing very positive signs of eventually
                            boosting GDP and productivity
                        snippet:
                          type: string
                          description: >-
                            A brief summary or description of the search result
                            content.
                          example: >-
                            2024-05-13 | the net impact on the labor market has
                            been positive thus far...
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        A unique API Key required to authorize API access. Ensure it is kept
        confidential. Get a free API Key at you.com/platform.

````