> ## Documentation Index > Fetch the complete documentation index at: https://docs.particle.pro/llms.txt > Use this file to discover all available pages before exploring further. # Get your transcription overview > Returns what you need to plan transcription requests: your limits and how much of them you have used, your requests by state, and the shared queue's depth with the median and 90th percentile time from request to transcript over the last 7 days. Not billed. ## OpenAPI ````yaml /openapi.json get /v1/podcasts/transcription openapi: 3.1.0 info: contact: email: api@particle.pro name: Particle url: https://particle.pro description: >- Podcast API for transcripts, mentions and sponsorship data. 140,000+ podcasts transcribed, diarized and speaker-identified within minutes of airing, about 28,000 episodes a day. Search transcripts by keyword or meaning, track brand and company mentions with alerts, pull sponsor and ad-read data and rankings. REST API plus an MCP server for AI agents. Also company, people and topic intelligence. summary: >- Podcast API: transcripts, mentions, sponsors and rankings for 140,000+ podcasts. termsOfService: https://particle.pro/legal/tos-api title: Particle API version: 0.1.0 x-guidance: >- Podcast, people, company and topic intelligence. Authenticate with a pp_ API key (X-API-Key header) or pay per request with x402: a keyless call to a billable endpoint returns 402 with the payment requirements in the PAYMENT-REQUIRED header; sign the USDC transfer and repeat the request with PAYMENT-SIGNATURE. Start with GET /v1/podcasts/search?q=; the slugs in responses are the inputs to the other endpoints. Docs: https://docs.particle.pro; setup playbook: https://api.particle.pro/agents.md; endpoint and tool map with prices: https://api.particle.pro/llms.txt; credential recipe: https://api.particle.pro/auth.md. x-logo: url: https://particle.pro/favicon.svg servers: - url: https://api.particle.pro security: - ApiKeyHeader: [] - BearerAuth: [] externalDocs: url: https://docs.particle.pro paths: /v1/podcasts/transcription: get: tags: - Podcast Transcription - tier:free summary: Get your transcription overview description: >- Returns what you need to plan transcription requests: your limits and how much of them you have used, your requests by state, and the shared queue's depth with the median and 90th percentile time from request to transcript over the last 7 days. Not billed. operationId: get-podcast-transcription-overview responses: '200': content: application/json: schema: $ref: '#/components/schemas/TranscriptionOverview' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/PlatformError' description: Error x-codeSamples: - label: cURL lang: curl source: |- curl -H "X-API-Key: $PARTICLE_API_KEY" \ "https://api.particle.pro/v1/podcasts/transcription" components: schemas: TranscriptionOverview: additionalProperties: false properties: limits: $ref: '#/components/schemas/TranscriptionLimits' queue: $ref: '#/components/schemas/TranscriptionQueueETA' requests: description: Your organization's requests in each state. items: $ref: '#/components/schemas/TranscriptionCount' type: - array - 'null' required: - limits - requests - queue type: object PlatformError: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string error_code: type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string resolve: $ref: '#/components/schemas/ErrorResolve' status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object TranscriptionLimits: additionalProperties: false properties: daily_requests: description: Requests made in the last 24 hours. format: int64 type: integer daily_requests_limit: description: The most requests that may be made in 24 hours. format: int64 type: integer daily_requests_resets_at: description: When the oldest request in the 24-hour window leaves it. format: date-time type: string open_requests: description: Requests queued or being transcribed. format: int64 type: integer open_requests_limit: description: The most requests that may be open at once. format: int64 type: integer required: - open_requests - open_requests_limit - daily_requests - daily_requests_limit type: object TranscriptionQueueETA: additionalProperties: false properties: median_turnaround_seconds: description: >- Median seconds from request to transcript over the last 7 days. Absent when nothing was transcribed in that window. format: double type: number p90_turnaround_seconds: description: >- 90th percentile seconds from request to transcript over the last 7 days. format: double type: number queued_episodes: description: Episodes waiting to be transcribed, across all organizations. format: int64 type: integer required: - queued_episodes type: object TranscriptionCount: additionalProperties: false properties: count: format: int64 type: integer state: enum: - queued - admitted - transcribed - failed type: string required: - state - count type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ErrorResolve: additionalProperties: false properties: action: type: string endpoint: type: string message: type: string method: type: string url: type: string required: - message type: object securitySchemes: ApiKeyHeader: description: Pass your API key in the X-API-Key header (recommended). in: header name: X-API-Key type: apiKey BearerAuth: description: Pass your API key as a Bearer token in the Authorization header. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.