Linked Jazz

Linked Jazz

API Documentation

This document explains the Linked Jazz API which returns data from the project's transcript analysis and crowdsourcing programs. For the Jazz Name Directory, please visit this page.

The Base URL is:

http://linkedjazz.org/api/

This api has three end points that accept GET requests:

Data is returned by default in JSON format, some requests allow the return of the data in RDF Triple format if a "/nt" is append to the request url. Likewise, the relationship endpoint will return a GEXF network file for use in Gephi network analysis program if "/gexf" is append to the request (examples provided below).

Quick Start Examples:


Get all people in json and RDF Triple:
http://linkedjazz.org/api/people/all
http://linkedjazz.org/api/people/all/nt

Get relationships for Mary Lou Williams in json and triple:
http://linkedjazz.org/api/relationships/%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FMary_Lo...
http://linkedjazz.org/api/relationships/%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FMary_Lo.../nt

Get Mary Lou Williams's Ego network in Gephi's GEXF format:
http://linkedjazz.org/api/relationships/ego/%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FMar.../gexf

Get all relationships in Triple format which includes crowdsourcing data:
http://linkedjazz.org/api/relationships/all/nt

People

The people endpoint has a search request and a dump endpoint. Entities that are returned appear in the transcripts analyzed and have relationships associated with them. To search add "search/XYZ" to the url. For example to search for people with the word "Fats" in their name use:

http://linkedjazz.org/api/people/search/Fats

Will return a array of objects with names matching the search request.

[
    {
        "name": "Fats Navarro",
        "uri": "<http://dbpedia.org/resource/Fats_Navarro>",
        "uriEncoded": "%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FFats_Navarro%3E",
        "image": "http://linkedjazz.org/image/square/Fats_Navarro.png"
    },
        {
        "name": "Fats Waller",
        "uri": "<http://dbpedia.org/resource/Fats_Waller>",
        "uriEncoded": "%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FFats_Waller%3E",
        "image": "http://linkedjazz.org/image/square/Fats_Waller.png"
    }
]

This API uses the full URI for requests, the URI must be encoded, forward slashes must be represented by %2F

http://linkedjazz.org/api/people/search/Fats/nt

Will return the same information in RDF Triple format.

To download all idividuals at once (data dump) use:

http://linkedjazz.org/api/people/all

Data dumps are updated hourly.

Relationships

Relationship information has two facets:

  1. That a basic rel:knowsOf relationship exists and its direction.
  2. Annotations from the crowdsourcing tool as to the more specific nature of the relationship.

All annotations are returned for a specific relationship, these annotations are added to the system by visitors to the 52nd St. crowdsourcing tool. Currently the API does not aggregate the varying opinions of a specific relationship into a quantified value, it just returns all opinions (even duplicate). This endpoint has the ability to return Gephi compatible GEXF files by appending "/gexf" to the url. Annotated relationships are not returned in the Gephi network, only a single basic rel:knowsOf. This endpoint can also return triples with the "/nt" argument.

You can request:

To return all relationships an idividual has pass their encoded URI as the seconf argument:

 http://linkedjazz.org/api/relationships/%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FFats_Navarro%3E 

To return their ego network add /ego/:

 http://linkedjazz.org/api/relationships/ego/%3Chttp%3A%2F%2Fdbpedia.org%2Fresource%2FFats_Navarro%3E 

To return all relationships:

 http://linkedjazz.org/api/relationships/all

Again, adding "/nt" or "/gexf" will return the request in that format.

JSON Response:

Text

The text endpoint simply returns text from the transcript, pass it the transcript hash ID along with the localId numbers you want seperated by commas. This informaton is returned in the realtionship calls. For example:

 http://linkedjazz.org/api/text/f3f0c653ce34f6ff5b6c11734cbe154a/1,5,6,7,4,3

Only JSON response for the text endpoint are available.


100 Examples

Name Links