API / Widget

Our system do not process your video instantly, you must add youtube video url to queue, then our worker will process it as soon as possible. And you can check the result via status API

Every API call will need an access key to use. Currently we do not allow public registration, but we provide you a public access key (limit 1000 calls per hour, that's more than enough for normal use). If you need a higher plan, please contact us via contact form.

If you are using wordpress plugin WP-ROBOT, please check our WP-ROBOT Subtitle Plugin, automatically get subtitles from youtube and insert into content via template tag.

If you have any problems or questions, please feel free to contact us via contact form.


ACCESS KEY (PUBLIC)

cd4RvKxwXRfFukJJ3uWxVbXk

Limit: 1000 calls per hour. For more calls, you can request PRIVATE ACCESS KEY here


QUEUE API


Queue single video

http://subtitlesdownloader.com/api/queue?video_url=VIDEO_URL&access_key=ACCESS_KEY
Params:
VIDEO_URL: video url (url encode please)

Response JSON:
{
status: "ok",
queue_id: "582bc8d9b6d87feb538b4567"
}

Queue single channel (beta, must use approved access key)

http://subtitlesdownloader.com/api/queue_channel?channel_url=CHANNEL_URL&access_key=ACCESS_KEY
Params:
VIDEO_URL: video url (url encode please)

Response JSON:
{
status: "ok",
queue_id: "582bc8d9b6d87feb538b4567"
}

Queue multi videos search by keyword

http://subtitlesdownloader.com/api/queue_by_keyword?s=KEYWORD&limit=LIMIT&access_key=ACCESS_KEY
Params:
KEYWORD: your keyword (url encode please)
LIMIT: value between 1 and 50

Response JSON:
{
status: "ok",
queue_ids: ["582bc8d9b6d87feb538b4567", "582bc8d9b6d87feb538b4567"]
}

STATUS API


Get status single queue

http://subtitlesdownloader.com/api/status?queue_id=QUEUE_ID&access_key=ACCESS_KEY
Params:
QUEUE_ID: queue_id (the result in queue api)

Response JSON:
{
status: "running",
queue_id: "582bc8dbb6d87feb538b4593"
video_url: "https://www.youtube.com/watch?v=andad_Rd2ZU"
queue_timestamp: {"sec": 1479264475, "usec": 846000}
process: "Getting Video Info"
video_id: "582bc93ab6d87fff1a8b45b5"
}

Get status multi queues

Not available yet