openapi: 3.0.1
servers:
  - url: https://prod.api.market/api/v1/brave/brave
info:
  title: Google Search API
  description: Internet Search Results API is a privacy-focused search engine by
    Brave browser developers, prioritizing user security and transparency.
  version: 1.0.0
paths:
  /videos/search:
    get:
      summary: Search Videos
      description: Retrieve video search results based on query parameters
      parameters:
        - name: q
          in: query
          required: true
          description: Search query
          schema:
            type: string
        - name: count
          in: query
          required: false
          description: Number of results to return
          schema:
            type: integer
            default: 10
        - name: country
          in: query
          required: false
          description: Country code
          schema:
            type: string
            default: us
        - name: search_lang
          in: query
          required: false
          description: Search language
          schema:
            type: string
            default: en
        - name: spellcheck
          in: query
          required: false
          description: Enable spellcheck
          schema:
            type: boolean
            default: true
      responses:
        "200":
          description: Successful video search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
      security:
        - ApiKeyAuth: []
    parameters:
      - &a1
        description: API.market API Key
        in: header
        name: x-api-market-key
        value: Please Login/Signup to get an API Key
        required: true
        schema:
          type: string
  /web/search:
    get:
      summary: Search Web
      description: Retrieve web search results based on query parameters
      parameters:
        - name: q
          in: query
          required: true
          description: Search query
          schema:
            type: string
      responses:
        "200":
          description: Successful web search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
      security:
        - ApiKeyAuth: []
    parameters:
      - *a1
  /images/search:
    get:
      summary: Search Images
      description: Retrieve image search results based on query parameters
      parameters:
        - name: q
          in: query
          required: true
          description: Search query
          schema:
            type: string
        - name: safesearch
          in: query
          required: false
          description: Safe search filter
          schema:
            type: string
            default: strict
        - name: count
          in: query
          required: false
          description: Number of results to return
          schema:
            type: integer
            default: 20
        - name: search_lang
          in: query
          required: false
          description: Search language
          schema:
            type: string
            default: en
        - name: country
          in: query
          required: false
          description: Country code
          schema:
            type: string
            default: us
        - name: spellcheck
          in: query
          required: false
          description: Enable spellcheck
          schema:
            type: boolean
            default: true
      responses:
        "200":
          description: Successful image search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
      security:
        - ApiKeyAuth: []
    parameters:
      - *a1
  /news/search:
    get:
      summary: Search News
      description: Retrieve news search results based on query parameters
      parameters:
        - name: q
          in: query
          required: true
          description: Search query
          schema:
            type: string
        - name: count
          in: query
          required: false
          description: Number of results to return
          schema:
            type: integer
            default: 10
        - name: country
          in: query
          required: false
          description: Country code
          schema:
            type: string
            default: us
        - name: search_lang
          in: query
          required: false
          description: Search language
          schema:
            type: string
            default: en
        - name: spellcheck
          in: query
          required: false
          description: Enable spellcheck
          schema:
            type: boolean
            default: true
      responses:
        "200":
          description: Successful news search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
      security:
        - ApiKeyAuth: []
    parameters:
      - *a1
  /suggest/search:
    get:
      summary: Search Suggestions
      description: Retrieve search suggestions based on query parameters
      parameters:
        - name: q
          in: query
          required: true
          description: Search query
          schema:
            type: string
        - name: country
          in: query
          required: false
          description: Country code
          schema:
            type: string
            default: US
        - name: count
          in: query
          required: false
          description: Number of suggestions to return
          schema:
            type: integer
            default: 5
      responses:
        "200":
          description: Successful search suggestions
          content:
            application/json:
              schema:
                type: object
                properties:
                  suggestions:
                    type: array
                    items:
                      type: object
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
      security:
        - ApiKeyAuth: []
    parameters:
      - *a1
  /spellcheck/search:
    get:
      summary: Spellcheck Search
      description: Retrieve spellcheck suggestions based on query parameters
      parameters:
        - name: q
          in: query
          required: true
          description: Search query
          schema:
            type: string
        - name: country
          in: query
          required: false
          description: Country code
          schema:
            type: string
            default: US
      responses:
        "200":
          description: Successful spellcheck suggestions
          content:
            application/json:
              schema:
                type: object
                properties:
                  spellcheck:
                    type: array
                    items:
                      type: object
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
      security:
        - ApiKeyAuth: []
    parameters:
      - *a1
components:
  securitySchemes: {}
security: {}
tags:
  - name: data
    description: Operations related to data
  - name: search
    description: Operations related to search