transcript-yt-com Summary API
The Summary API from transcript-yt-com — 1 operation(s) for summary.
The Summary API from transcript-yt-com — 1 operation(s) for summary.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/transcript-yt-com:transcript-yt-com-summary-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a 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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Transcript Yt Com Summary API
version: 1.0.0
contact:
email: aadit@techiseasy.co.in
url: https://transcript-yt.com
termsOfService: https://transcript-yt.com/terms
description: 'Operations tagged Summary across 2 of this provider''s published API definitions: openapi.json, transcript-yt-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://transcript-yt.com
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Summary
paths:
/v1/summary:
get:
operationId: getSummary
summary: Summarize a YouTube video
description: 'Summary, key points, and timestamped study notes generated from the video''s transcript, in the transcript''s language. Costs 1 credit for the transcript (with the same AI-transcription fallback as /v1/transcript) plus the summary''s AI cost: 1 credit for videos up to about 25 minutes and for cached summaries, about 1 more per further 45 minutes of speech. X-Credits-Charged shows the total. Failed requests are not billed.'
parameters:
- name: url
in: query
required: true
description: A YouTube URL (watch, youtu.be, shorts, embed) or a bare 11-character video ID.
schema:
type: string
example: 5f3Pn-N6yLc
- name: language
in: query
description: BCP-47 code selecting which caption track to summarize.
schema:
type: string
pattern: ^[A-Za-z0-9-]{2,16}$
- name: translate_to
in: query
description: BCP-47 target code. Summarizes a machine-translated transcript instead of the original.
schema:
type: string
pattern: ^[A-Za-z0-9-]{2,16}$
responses:
'200':
description: Summary
headers:
X-RateLimit-Limit:
schema:
type: integer
X-RateLimit-Remaining:
schema:
type: integer
X-RateLimit-Reset:
schema:
type: integer
description: Unix seconds when the window resets.
X-Credits-Charged:
schema:
type: integer
X-Credits-Remaining:
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/Summary'
'400':
description: INVALID_REQUEST or INVALID_VIDEO
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: UNAUTHORIZED
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Out of credits
content:
application/json:
schema:
$ref: '#/components/schemas/OutOfCredits'
'404':
description: VIDEO_UNAVAILABLE, NO_CAPTIONS, or LANGUAGE_NOT_AVAILABLE
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: RATE_LIMITED
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: UPSTREAM_ERROR
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: 'SERVICE_UNAVAILABLE: summaries disabled, or BLOCKED (temporary, retry shortly)'
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Summary
post:
operationId: postSummary
summary: Summarize a YouTube video (JSON body)
description: Same as GET /v1/summary with parameters in a JSON body.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- url
properties:
url:
type: string
language:
type: string
pattern: ^[A-Za-z0-9-]{2,16}$
translate_to:
type: string
pattern: ^[A-Za-z0-9-]{2,16}$
responses:
'200':
description: Summary
content:
application/json:
schema:
$ref: '#/components/schemas/Summary'
'400':
description: INVALID_REQUEST or INVALID_VIDEO
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: UNAUTHORIZED
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'402':
description: Out of credits
content:
application/json:
schema:
$ref: '#/components/schemas/OutOfCredits'
'404':
description: VIDEO_UNAVAILABLE, NO_CAPTIONS, or LANGUAGE_NOT_AVAILABLE
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: RATE_LIMITED
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'502':
description: UPSTREAM_ERROR
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'503':
description: SERVICE_UNAVAILABLE
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
tags:
- Summary
servers:
- url: https://transcript-yt.com
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
enum:
- INVALID_REQUEST
- INVALID_VIDEO
- VIDEO_UNAVAILABLE
- NO_CAPTIONS
- LANGUAGE_NOT_AVAILABLE
- BLOCKED
- UPSTREAM_ERROR
- UNAUTHORIZED
- RATE_LIMITED
- SERVICE_UNAVAILABLE
- INTERNAL
message:
type: string
Summary:
type: object
properties:
videoId:
type: string
title:
type:
- string
- 'null'
author:
type:
- string
- 'null'
language:
type: string
cached:
type: object
properties:
transcript:
type: boolean
summary:
type: boolean
summary:
type: string
description: 2-4 sentence overview.
keyPoints:
type: array
items:
type: string
notes:
type: array
description: Timestamped study notes, in video order.
items:
type: object
properties:
start:
type: number
description: Seconds
heading:
type: string
bullets:
type: array
items:
type: string
OutOfCredits:
type: object
properties:
error:
type: string
example: Out of credits
plan:
type: string
credits_remaining:
type: integer
upgrade_url:
type: string
topup_url:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key, e.g. ts_live_...
apiKeyHeader:
type: apiKey
in: header
name: x-api-key
externalDocs:
url: https://transcript-yt.com/docs
x-refined-from:
- openapi.json
- transcript-yt-com-openapi.json