Interpreting Search Results

All Vertx tools deliver search results in JSON format. Each result contains the following JSON fields:

  • media_content indicates type of the content being searched (audio or video);
  • source_path - path of the source (query) file;
  • source_uid - unique identifier of the source (query) file;
  • status - status of the search call (“succeeded” or “failed”).

Each result also contains a list of matches with the reference content:

  • type - type of the reference content (can be "movie" or "music");
  • title - title of the reference content (track or movie title);
  • uid - a unique identifier of the reference content.

Metadata information specific to movies:

  • imdb_id - IMDB identifier of the reference movie;
  • year - release year of the movie.

Metadata information specific to music:

  • artist - artist;
  • album - album.

Every match contains the following information:

  • duration - duration (in seconds) of the match segment;
  • que_offset - the offset to the match segment in the input (query) file (in seconds);
  • ref_offset - the offset to the match segment in the reference item (in seconds).

The resulting JSON response for the sample.mp4 request media file:

[
  {
    "matches": [
      {
        "album": "Elephunk",
        "artist": "Black Eyed Peas; Papa Roach",
        "segments": [
          {
            "duration": 24.9375,
            "que_offset": 0.0,
            "ref_offset": 18.0
          }
        ],
        "title": "Anxiety",
        "type": "music",
        "uid": 6475547275973858650
      },
      {
        "imdb_id": 365957,
        "segments": [
          {
            "duration": 24.9375,
            "que_offset": 0.0,
            "ref_offset": 3500.625
          }
        ],
        "title": "You Got Served",
        "type": "movie",
        "uid": 1566530810344932800,
        "year": 2004
      }
    ],
    "media_type": "audio",
    "source_path": "sample.mp4",
    "source_uid": 1758730481226206085,
    "status": "succeeded"
  },
  {
    "matches": [
      {
        "imdb_id": 332452,
        "segments": [
          {
            "duration": 21.0,
            "que_offset": 0.0,
            "ref_offset": 8608.5
          }
        ],
        "title": "Troy",
        "type": "movie",
        "uid": 1342729426672482861,
        "year": 2004
      }
    ],
    "media_type": "video",
    "source_path": "sample.mp4",
    "source_uid": 1758730481226206085,
    "status": "succeeded"
  }
]

The content from sample.mp4 file matched with three items from the public bucket. Video content matched with the “Troy” movie, while audio content matched with the “Anxiety” music track by “Black Eyed Peas” and “Papa Roach”. The song was also used as a soundtrack in “You Got Served” movie. Vertx was able to successfully identify all the matching segments, both audio and video.

Previous
Next