Audioscrape Agent rail API

openapi: 3.2.0
info:
  title: Audioscrape Com Agent rail API
  version: '2026-05-16'
  contact:
    name: Audioscrape
    url: https://www.audioscrape.com
    email: lukas@audioscrape.com
  license:
    name: ''
  description: 'Operations tagged Agent rail across 2 of this provider''s published API definitions: audioscrape-com-openapi.json, audioscrape-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.audioscrape.com
  description: Production
tags:
- name: Agent rail
  description: 'Pay-as-you-go answers for AI agents over HTTP 402: a pay-as-you-go workspace balance topped up by card or Link through the Machine Payments Protocol (Stripe), and x402 (USDC per call) where the 402 offers it. A first top-up opens the workspace and returns its API key and a claim link. Subscribers'' keys are served within the plan. Price list: GET /api/agent/v1'
paths:
  /api/agent/v1:
    get:
      tags:
      - Agent rail
      summary: The free, machine-readable price list
      operationId: manifest
      responses:
        '200':
          description: Prices, payment protocols and limits for AI agents
    servers:
    - url: https://www.audioscrape.com
      description: Production
  /api/agent/v1/credits:
    get:
      tags:
      - Agent rail
      summary: The workspace's balance and recent movements (free)
      operationId: credit_balance
      responses:
        '200':
          description: Pricing mode, balance in micro-dollars and the last 20 entries
        '401':
          description: Missing or unknown API key
      security:
      - BearerAuth: []
    post:
      tags:
      - Agent rail
      summary: Tops up a pay-as-you-go balance (MPP or x402); without a key, opens the…
      operationId: buy_credit
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BuyCreditRequest'
        required: true
      responses:
        '200':
          description: 'Paid: the balance; on a first top-up also the workspace API key and a claim link (shown once)'
        '402':
          description: 'Challenge: WWW-Authenticate (MPP, method=stripe) and/or PAYMENT-REQUIRED (x402)'
        '409':
          description: The key's workspace is on a plan
        '503':
          description: Rail or both protocols not enabled
    servers:
    - url: https://www.audioscrape.com
      description: Production
  /api/agent/v1/excerpt:
    get:
      tags:
      - Agent rail
      summary: Paid transcript excerpt around a moment
      operationId: excerpt
      parameters:
      - name: episode_id
        in: query
        description: Recording id (from a search result).
        required: true
        schema:
          type: integer
          format: int64
      - name: t
        in: query
        description: Moment in seconds.
        required: true
        schema:
          type: number
          format: double
      - name: seconds
        in: query
        description: Seconds after the moment, 10–180 (default 90).
        required: false
        schema:
          type:
          - number
          - 'null'
          format: double
      responses:
        '200':
          description: Segments around the moment and a link to it
        '402':
          description: 'Payment required: an anonymous call, or a key whose balance is empty, is paid per call'
        '404':
          description: Unknown, private or untranscribed recording (never charged)
      security:
      - BearerAuth: []
      - {}
    servers:
    - url: https://www.audioscrape.com
      description: Production
  /api/agent/v1/overview:
    get:
      tags:
      - Agent rail
      summary: Paid overview of one recording
      operationId: overview
      parameters:
      - name: episode_id
        in: query
        description: Recording id (from a search result).
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Chapters, top entities and duration
        '402':
          description: 'Payment required: an anonymous call, or a key whose balance is empty, is paid per call'
        '404':
          description: Unknown or private recording (never charged)
      security:
      - BearerAuth: []
      - {}
    servers:
    - url: https://www.audioscrape.com
      description: Production
  /api/agent/v1/search:
    post:
      tags:
      - Agent rail
      summary: Paid search
      operationId: search
      parameters:
      - name: scope
        in: query
        description: '`podcasts`, or `government` (public meetings and court hearings).

          Unset: the whole record.'
        required: false
        schema:
          type:
          - string
          - 'null'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentSearchRequest'
        required: true
      responses:
        '200':
          description: Matching segments with links to the moment (empty results are free)
        '400':
          description: Invalid request (never charged)
        '402':
          description: 'Payment required: an anonymous call, or a key whose balance is empty, is paid per call; the body lists the ways to pay that are open (a balance top-up, and x402''s PAYMENT-REQUIRED header where offered)'
      security:
      - BearerAuth: []
      - {}
    servers:
    - url: https://www.audioscrape.com
      description: Production
  /api/agent/v1/transcribe:
    post:
      tags:
      - Agent rail
      summary: Transcribes a recording into the key's workspace
      operationId: transcribe
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentTranscribeRequest'
        required: true
      responses:
        '200':
          description: 'Accepted: job_id to poll at /api/agent/v1/transcriptions/{job_id}'
        '401':
          description: A workspace API key is needed (a first top-up returns one)
        '403':
          description: 'The key''s workspace is read-only: it holds no recordings'
      security:
      - BearerAuth: []
    servers:
    - url: https://www.audioscrape.com
      description: Production
  /api/agent/v1/transcriptions/{job_id}:
    get:
      tags:
      - Agent rail
      summary: The state of a transcription job in the key's workspace (free)
      operationId: transcription_status
      parameters:
      - name: job_id
        in: path
        description: Job id from /api/agent/v1/transcribe
        required: true
        schema:
          type: integer
          format: int64
      responses:
        '200':
          description: Status; 'waiting' with a reason when the balance or allowance falls short
        '404':
          description: No such job in this workspace
      security:
      - BearerAuth: []
    servers:
    - url: https://www.audioscrape.com
      description: Production
components:
  schemas:
    AgentTranscribeRequest:
      type: object
      required:
      - url
      properties:
        title:
          type:
          - string
          - 'null'
        url:
          type: string
          description: https URL of an audio or video file.
    BuyCreditRequest:
      type: object
      properties:
        amount_cents:
          type:
          - integer
          - 'null'
          format: int64
          description: Balance to buy in US cents, 500–10,000 (default 500).
    AgentSearchRequest:
      type: object
      required:
      - query
      properties:
        content_types:
          type:
          - array
          - 'null'
          items:
            type: string
          description: e.g. `government_meeting`, `court_hearing`, `podcast_episode`.
        date_from:
          type:
          - string
          - 'null'
          description: YYYY-MM-DD.
        date_to:
          type:
          - string
          - 'null'
          description: YYYY-MM-DD.
        limit:
          type:
          - integer
          - 'null'
          format: int32
          description: 1–10 results (default 5).
        query:
          type: string
          description: What to find, 1–300 characters.
        search_type:
          type:
          - string
          - 'null'
          description: '`text` (default) or `semantic`.'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key, format `sk_<base64(32 random bytes)>`
      description: 'Workspace-scoped API key. Pass as `Authorization: Bearer <key>`. The `?api_key=<key>` query parameter is deprecated: a key in a URL ends up in browser history, proxy logs and Referer headers.'
x-refined-from:
- audioscrape-com-openapi.json
- audioscrape-com-openapi.json