Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: PodKit Usage API
version: 0.1.0
description: Podcast data API — search, podcast + episode metadata, chapters, and transcripts. Authenticate with an API key in the `x-api-key` header.
tags:
- name: Usage
paths:
/v1/usage:
get:
tags:
- Usage
summary: Check current plan usage (free — does not count against your quota)
description: 'Returns the API key''s current plan, monthly request quota, requests used this calendar month, remaining requests, the UTC quota-reset timestamp, and the per-minute burst limit. This call is read-only and free: it does NOT increment your usage counter and is not subject to the per-minute burst limit.'
responses:
'200':
description: Current usage for the authenticated key
content:
application/json:
schema:
$ref: '#/components/schemas/Usage'
'401':
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
operationId: getV1Usage
x-operation-id-source: derived
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
required:
- code
- message
required:
- error
Usage:
type: object
properties:
plan:
type: string
example: starter
limit:
type: number
description: Monthly request quota for the plan.
example: 10000
current:
type: number
description: Requests used so far this calendar month.
example: 3200
remaining:
type: number
description: limit − current, floored at 0.
example: 6800
resetsAt:
type: string
description: UTC start of next month (quota reset).
example: '2026-08-01T00:00:00.000Z'
rateLimit:
type: object
properties:
perMinute:
type: number
description: Per-minute burst limit for the plan.
example: 30
required:
- perMinute
required:
- plan
- limit
- current
- remaining
- resetsAt
- rateLimit