Poll for tool job result
Check the status of an async tool job (download or transcript). Returns processing, completed with result, or failed with error.
Authorization
Bearer API key (rlay_live_* or rlay_test_*)
In: header
Path Parameters
Job ID returned from a download or transcript request
Response Body
application/json
application/json
curl -X GET "https://api.relayapi.dev/v1/tools/jobs/string"{
"job_id": "string",
"status": "processing",
"type": "download",
"created_at": "2019-08-24T14:15:22Z",
"completed_at": "2019-08-24T14:15:22Z",
"result": {
"property1": null,
"property2": null
},
"error": "string",
"error_code": "string"
}{
"error": {
"code": "string",
"message": "string",
"details": {
"property1": null,
"property2": null
}
}
}Found something wrong? Help us improve this page.
Download YouTube video POST
Returns available formats and direct download URL. Responds with 200 if the result is ready immediately, or 202 with a job_id to poll if processing takes longer. Rate limited by daily tool quota.
Extract YouTube video transcript POST
Extracts captions/subtitles from a YouTube video. Returns segments with timestamps and the full concatenated text. Responds with 200 if ready immediately, or 202 with a job_id to poll.