API Reference 2.0

Metadata API

The metadata API will give you all the specs and info about a media file (input and output files).

Get all metadata from a given job

Endpoint: GET /v2/metadata/jobs/:jobid

curl -u "your-api-key:" https://api.coconut.co/v2/metadata/jobs/3rYmakTwcEoN6U

Response examples

{
  "job_id": "3wrNUqQmey2rsP",
  "metadata": {
    "input": {
      "streams": [
        {
          "index": 0,
          "codec_name": "h264",
          "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "profile": "High",
          "codec_type": "video",
          "codec_time_base": "1/60",
          "codec_tag_string": "avc1",
          "codec_tag": "0x31637661",
          "width": 854,
          "height": 480,
          "coded_width": 864,
          "coded_height": 480,
          "has_b_frames": 2,
          "sample_aspect_ratio": "1280:1281",
          "display_aspect_ratio": "16:9",
          "pix_fmt": "yuv420p",
          "level": 31,
          "chroma_location": "left",
          "refs": 1,
          "is_avc": "true",
          "nal_length_size": "4",
          "r_frame_rate": "30/1",
          "avg_frame_rate": "30/1",
          "time_base": "1/15360",
          "start_pts": 323,
          "start_time": "0.021029",
          "duration_ts": 922624,
          "duration": "60.066667",
          "bit_rate": "865345",
          "bits_per_raw_sample": "8",
          "nb_frames": "1802",
          "disposition": {
            "default": 1,
            "dub": 0,
            "original": 0,
            "comment": 0,
            "lyrics": 0,
            "karaoke": 0,
            "forced": 0,
            "hearing_impaired": 0,
            "visual_impaired": 0,
            "clean_effects": 0,
            "attached_pic": 0,
            "timed_thumbnails": 0
          },
          "tags": {
            "language": "und",
            "handler_name": "VideoHandler"
          }
        },
        {
          "index": 1,
          "codec_name": "aac",
          "codec_long_name": "AAC (Advanced Audio Coding)",
          "profile": "LC",
          "codec_type": "audio",
          "codec_time_base": "1/48000",
          "codec_tag_string": "mp4a",
          "codec_tag": "0x6134706d",
          "sample_fmt": "fltp",
          "sample_rate": "48000",
          "channels": 6,
          "channel_layout": "5.1",
          "bits_per_sample": 0,
          "r_frame_rate": "0/0",
          "avg_frame_rate": "0/0",
          "time_base": "1/48000",
          "start_pts": 0,
          "start_time": "0.000000",
          "duration_ts": 2880512,
          "duration": "60.010667",
          "bit_rate": "64505",
          "max_bit_rate": "64505",
          "nb_frames": "2813",
          "disposition": {
            "default": 1,
            "dub": 0,
            "original": 0,
            "comment": 0,
            "lyrics": 0,
            "karaoke": 0,
            "forced": 0,
            "hearing_impaired": 0,
            "visual_impaired": 0,
            "clean_effects": 0,
            "attached_pic": 0,
            "timed_thumbnails": 0
          },
          "tags": {
            "language": "und",
            "handler_name": "SoundHandler"
          }
        }
      ],
      "format": {
        "filename": "http://aws-us-east-1-media.coconut.co.s3.amazonaws.com/16/09/1206bbedaf944f7f60ca0e7607185fbd/0",
        "nb_streams": 2,
        "nb_programs": 0,
        "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
        "format_long_name": "QuickTime / MOV",
        "start_time": "0.000000",
        "duration": "60.067000",
        "size": "7047204",
        "bit_rate": "938579",
        "probe_score": 100,
        "tags": {
          "major_brand": "isom",
          "minor_version": "512",
          "compatible_brands": "isomiso2avc1mp41",
          "title": "Big Buck Bunny, Sunflower version",
          "artist": "Blender Foundation 2008, Janus Bager Kristensen 2013",
          "composer": "Sacha Goedegebure",
          "encoder": "Lavf57.25.100",
          "comment": "Creative Commons Attribution 3.0 - http://bbb3d.renderfarming.net",
          "genre": "Animation"
        }
      }
    },
    "outputs": [
      {
        "mp4": {
          "streams": [
            {
              "index": 0,
              "codec_name": "h264",
              "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
              "profile": "Constrained Baseline",
              "codec_type": "video",
              "codec_time_base": "1/60",
              "codec_tag_string": "avc1",
              "codec_tag": "0x31637661",
              "width": 854,
              "height": 480,
              "coded_width": 864,
              "coded_height": 480,
              "has_b_frames": 0,
              "sample_aspect_ratio": "1280:1281",
              "display_aspect_ratio": "16:9",
              "pix_fmt": "yuv420p",
              "level": 30,
              "chroma_location": "left",
              "refs": 1,
              "is_avc": "true",
              "nal_length_size": "4",
              "r_frame_rate": "30/1",
              "avg_frame_rate": "30/1",
              "time_base": "1/15360",
              "start_pts": 0,
              "start_time": "0.000000",
              "duration_ts": 923648,
              "duration": "60.133333",
              "bit_rate": "1339914",
              "bits_per_raw_sample": "8",
              "nb_frames": "1804",
              "disposition": {
                "default": 1,
                "dub": 0,
                "original": 0,
                "comment": 0,
                "lyrics": 0,
                "karaoke": 0,
                "forced": 0,
                "hearing_impaired": 0,
                "visual_impaired": 0,
                "clean_effects": 0,
                "attached_pic": 0,
                "timed_thumbnails": 0
              },
              "tags": {
                "language": "und",
                "handler_name": "VideoHandler"
              }
            },
            {
              "index": 1,
              "codec_name": "aac",
              "codec_long_name": "AAC (Advanced Audio Coding)",
              "profile": "LC",
              "codec_type": "audio",
              "codec_time_base": "1/44100",
              "codec_tag_string": "mp4a",
              "codec_tag": "0x6134706d",
              "sample_fmt": "fltp",
              "sample_rate": "44100",
              "channels": 2,
              "channel_layout": "stereo",
              "bits_per_sample": 0,
              "r_frame_rate": "0/0",
              "avg_frame_rate": "0/0",
              "time_base": "1/44100",
              "start_pts": 0,
              "start_time": "0.000000",
              "duration_ts": 2646441,
              "duration": "60.010000",
              "bit_rate": "106895",
              "max_bit_rate": "128000",
              "nb_frames": "2586",
              "disposition": {
                "default": 1,
                "dub": 0,
                "original": 0,
                "comment": 0,
                "lyrics": 0,
                "karaoke": 0,
                "forced": 0,
                "hearing_impaired": 0,
                "visual_impaired": 0,
                "clean_effects": 0,
                "attached_pic": 0,
                "timed_thumbnails": 0
              },
              "tags": {
                "language": "und",
                "handler_name": "SoundHandler"
              }
            }
          ],
          "format": {
            "filename": "http://cdn.coconut.co/video.mp4",
            "nb_streams": 2,
            "nb_programs": 0,
            "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
            "format_long_name": "QuickTime / MOV",
            "start_time": "0.000000",
            "duration": "60.134000",
            "size": "10926376",
            "bit_rate": "1453603",
            "probe_score": 100,
            "tags": {
              "major_brand": "isom",
              "minor_version": "512",
              "compatible_brands": "isomiso2avc1mp41",
              "title": "Big Buck Bunny, Sunflower version",
              "artist": "Blender Foundation 2008, Janus Bager Kristensen 2013",
              "composer": "Sacha Goedegebure",
              "encoder": "Lavf58.29.100",
              "comment": "Creative Commons Attribution 3.0 - http://bbb3d.renderfarming.net",
              "genre": "Animation"
            }
          }
        }
      }
    ]
  }
}

Get metadata of specific source / output

Endpoint: GET /v2/metadata/jobs/:jobid/:source_or_output-key-name

curl -u "your-api-key:" https://api.coconut.co/v2/metadata/jobs/3rYmakTwcEoN6U/mp4:trailer

Response examples

{
  "job_id": "3wrNUqQmey2rsP",
  "metadata": {
    "mp4:trailer": {
      "streams": [
        {
          "index": 0,
          "codec_name": "h264",
          "codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "profile": "Constrained Baseline",
          "codec_type": "video",
          "codec_time_base": "1/60",
          "codec_tag_string": "avc1",
          "codec_tag": "0x31637661",
          "width": 428,
          "height": 240,
          "coded_width": 432,
          "coded_height": 240,
          "has_b_frames": 0,
          "sample_aspect_ratio": "320:321",
          "display_aspect_ratio": "16:9",
          "pix_fmt": "yuv420p",
          "level": 30,
          "chroma_location": "left",
          "refs": 1,
          "is_avc": "true",
          "nal_length_size": "4",
          "r_frame_rate": "30/1",
          "avg_frame_rate": "30/1",
          "time_base": "1/15360",
          "start_pts": 0,
          "start_time": "0.000000",
          "duration_ts": 92160,
          "duration": "6.000000",
          "bit_rate": "114644",
          "bits_per_raw_sample": "8",
          "nb_frames": "180",
          "disposition": {
            "default": 1,
            "dub": 0,
            "original": 0,
            "comment": 0,
            "lyrics": 0,
            "karaoke": 0,
            "forced": 0,
            "hearing_impaired": 0,
            "visual_impaired": 0,
            "clean_effects": 0,
            "attached_pic": 0,
            "timed_thumbnails": 0
          },
          "tags": {
            "language": "und",
            "handler_name": "VideoHandler"
          }
        },
        {
          "index": 1,
          "codec_name": "aac",
          "codec_long_name": "AAC (Advanced Audio Coding)",
          "profile": "LC",
          "codec_type": "audio",
          "codec_time_base": "1/44100",
          "codec_tag_string": "mp4a",
          "codec_tag": "0x6134706d",
          "sample_fmt": "fltp",
          "sample_rate": "44100",
          "channels": 2,
          "channel_layout": "stereo",
          "bits_per_sample": 0,
          "r_frame_rate": "0/0",
          "avg_frame_rate": "0/0",
          "time_base": "1/44100",
          "start_pts": 0,
          "start_time": "0.000000",
          "duration_ts": 264600,
          "duration": "6.000000",
          "bit_rate": "96497",
          "max_bit_rate": "128000",
          "nb_frames": "260",
          "disposition": {
            "default": 1,
            "dub": 0,
            "original": 0,
            "comment": 0,
            "lyrics": 0,
            "karaoke": 0,
            "forced": 0,
            "hearing_impaired": 0,
            "visual_impaired": 0,
            "clean_effects": 0,
            "attached_pic": 0,
            "timed_thumbnails": 0
          },
          "tags": {
            "language": "und",
            "handler_name": "SoundHandler"
          }
        }
      ],
      "format": {
        "filename": "http://cdn.coconut.co/trailer.mp4",
        "nb_streams": 2,
        "nb_programs": 0,
        "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
        "format_long_name": "QuickTime / MOV",
        "start_time": "0.000000",
        "duration": "6.024000",
        "size": "165400",
        "bit_rate": "219654",
        "probe_score": 100,
        "tags": {
          "major_brand": "isom",
          "minor_version": "512",
          "compatible_brands": "isomiso2avc1mp41",
          "title": "Big Buck Bunny, Sunflower version",
          "artist": "Blender Foundation 2008, Janus Bager Kristensen 2013",
          "composer": "Sacha Goedegebure",
          "encoder": "Lavf58.29.100",
          "comment": "Creative Commons Attribution 3.0 - http://bbb3d.renderfarming.net",
          "genre": "Animation"
        }
      }
    }
  }
}