TwentyThree Developer APIAPI Method: /api/photo/subtitle/list

API Method: /api/photo/subtitle/list

Last updated on January 23, 2017.

Return the raw data (usually in JSON or WebSRT) to show subtitles, but required subsequent parsing.

Parameters

ParameterDescription
photo_id (required) The ID of the video to fetch subtitles for.
token (required) The corresponding token for the photo_id.
The token may be explicitly time-limited in which case expire becomes a required parameter.
subtitle_format Which format should the returned be in? Default: websrt
Valid values: websrt or json
locale Locale to fecth the specific subtitle for.

Permission level

The minimum required permission level is:

none

For non-public sites, the minimum level is:

anonymous

Example XML Response

<response status="ok" permission_level="anonymous" total_count="0" 
  cached="1" cache_time="1291206586">
  <json>
    {"subtitles":[{"timestamp_begin":2.414, ...
  </json>
</response>

<response status="ok" permission_level="anonymous" total_count="0" 
  cached="1" cache_time="1291206586">
  <websrt>1
  00:00:02,414 --&gt; 00:00:09,294
  First subtitle ...
  </websrt>
</response>

Example JSON Response

{
  "status": "ok", 
  "permission_level":"anonymous",
  "cached":"1",
  "cache_time":"1291206702",
  "data":{"json": "{"subtitles":[{"timestamp_begin  ...."},
  "p": "1",
  "size": "1",
  "total_count": "0",
  "site": { ... },
  "endpoint": "/api/photo/subtitle/list"
}