FreeSkillz.xyz API

Transcript, article fetch, media resolve, and temporary download endpoints.

REST API v1

Endpoints

The API exposes health, transcript, New York Times article fetch, media resolve, and temporary download routes.

GET

/healthz

Public service health check.

POST

/v1/youtube/transcript

Returns transcript text windows and optional timestamped segments for a YouTube URL or video id.

POST

/v1/youtube/transcript/languages

Lists available manual and auto caption languages.

POST

/nytimes/fetch

Uses a configured WebBrain browser to return a New York Times article. Requires a bearer token.

POST

/v1/media/resolve

Runs metadata extraction without downloading media.

POST

/v1/media/jobs

Creates a temporary media job; videos are merged and normalized to one QuickTime-compatible H.264/AAC MP4.

GET

/v1/media/jobs/{job_id}

Checks job state, progress, metadata, and expiry.

GET

/v1/media/jobs/{job_id}/file

Downloads the completed single-file media artifact.

DELETE

/v1/media/jobs/{job_id}

Deletes a completed, failed, or expired job and removes its media files.