BuyRecord Keys API

openapi: 3.2.0
info:
  title: BuyRecord Keys API
  description: 'BuyRecord publishes verified purchase outcomes (kept, kept and liked, complained, returned, with reasons) for products. Every outcome is tied to a proof of purchase: a connected Shopify store''s order record, or the merchant''s DKIM-signed order confirmation email. Scores run from 0 to 100, are shown from 5 verified outcomes and carry the number of outcomes and a confidence level. Scope: US online stores, 15 product categories, all prices; for products without a score, the price, availability, the store''s return policy and the rating the store publishes on its own site are returned, labelled apart from verified outcomes, with US CPSC recall flags. Verified stays (hotels and rentals) are scored the same way from DKIM-signed booking confirmations. Reading needs no key; submitting an outcome needs an API key or OAuth. No buyer personal data is stored. The same operations are available as an MCP server at https://api.buyrecord.app/mcp. Summary: https://buyrecord.app/llms.txt; methodology: https://buyrecord.app/methodology.html.'
  version: 0.1.0
tags:
- name: Keys
paths:
  /v1/keys:
    post:
      summary: Create Api Key
      description: Issue an API key for writing, instantly. Starter limits; a few keys per requester per day.
      operationId: create_api_key
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KeyRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssuedKey'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Keys
components:
  schemas:
    IssuedKey:
      properties:
        key:
          type: string
          title: Key
          description: 'Shown once. Send it as ''Authorization: Bearer <key>''.'
        prefix:
          type: string
          title: Prefix
        reads_per_minute:
          type: integer
          title: Reads Per Minute
        writes_per_minute:
          type: integer
          title: Writes Per Minute
      type: object
      required:
      - key
      - prefix
      - reads_per_minute
      - writes_per_minute
      title: IssuedKey
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    KeyRequest:
      properties:
        label:
          type: string
          maxLength: 80
          minLength: 3
          pattern: ^[A-Za-z0-9][A-Za-z0-9 ._()-]*$
          title: Label
          description: Name of the agent or project using the key, e.g. 'Acme shopping agent'.
      type: object
      required:
      - label
      title: KeyRequest
  securitySchemes:
    HTTPBearer:
      type: http
      description: API key (br_live_...). Required for writing.
      scheme: bearer