LOV API documentation

Functions defined in LOV can be called with an HTTP GET request. The response to the function you call is in JSON format. Browser plugins like JSONView for Firefox or Chrome will format and color LOV's JSON response nicely in your browser.
Vocabulary Term (Class, Property, Datatype, Instance)
  • get/api/v2/term/search

    Search Term API v2
    The Search Term API allows a user to search over Linked Open Vocabularies ecosystem for a vocabulary term (class, property, datatype or instance).
    Parameter Type Description
    q string Full text query.
    page_size int Maximum number of results to return per page (default: 10).
    page int Result page to display starting from 1 (default: 1).
    type string Filter query results based on their type. Possible values: [class, propery, datatype, instance]. Multiple values allowed (use coma without space to seperate them).
    vocab string Filter query results based on the vocabulary it belongs to (e.g. "foaf"). Expecting only one value.
    vocab_limit int Number of elements to display in the vocabulary facet (default: 10).
    tag string Filter query results based on their tag (e.g. "event"). Multiple values allowed, use coma as a separator (e.g. "event,time").
    tag_limit int Number of elements to display in the tag facet (default: 10).
    For example, using the LOV Search Term API, your app can search for all classes with the term "Person" in any litteral value: http://lov.okfn.org/dataset/lov/api/v2/term/search?q=Person&type=class
  • get/api/v2/term/autocomplete

    Autocomplete Term API v2
    The Autocomplete Term API allows a user to get autocompletion recommendations for terms in Linked Open Vocabularies ecosystem. The autocompletion is performed on terms URI (e.g. http://xmlns.com/foaf/0.1/Person) or terms prefixed URI (foaf:Person). The user can ask for autocompletion from 1 character and filter by type class or property.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    type string Filter query results type: "property" or "class" (if no type is given, will search over property AND class types.)
    page_size int Maximum number of results to return per page (default: 10).
    For example, using the Autocomplete Term API, your app can search for all classes with terms URI or Prefixed URI begining with "foaf:": http://lov.okfn.org/dataset/lov/api/v2/term/autocomplete?q=foaf:p&type=class
  • get/api/v2/term/suggest

    Suggest Term API v2
    The Suggest Term API allows a user to get suggestion of vocabulary terms label based on the labels stored in LOV. It is useful for instance to help fix some typos for a search engine.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    type string Filter suggestions based on their type. Possible values: [class, propery, datatype, instance]. Multiple values allowed (use coma without space to seperate them).
    page_size int Maximum number of results to return per page (default: 10).
    For example, using the Suggest Term API, your app can get suggestion of misspelled query terms such as "preson": http://lov.okfn.org/dataset/lov/api/v2/term/suggest?q=preson
Vocabulary
  • get/api/v2/vocabulary/list

    List Vocab API v2
    The List Vocab API allows a user to list the vocabularies part of the Linked Open Vocabularies ecosystem.
    Parameter Type Description
    - - -
    For example, using the List Vocab API, your app can list all vocabularies in LOV: http://lov.okfn.org/dataset/lov/api/v2/vocabulary/list
  • get/api/v2/vocabulary/search

    Search Vocab API v2
    The Search Vocab API allows a user to search over Linked Open Vocabularies ecosystem for a Vocabulary based on its title or prefix.
    Parameter Type Description
    q string Full text query.
    page_size int Maximum number of results to return per page (default: 10).
    page int Result page to display starting from 1 (default: 1).
    tag string Filter query results based on their tag (e.g. "event"). Multiple values allowed, use coma as a separator (e.g. "event,time").
    tag_limit int Number of elements to display in the tag facet (default: 10).
    lang string Filter query results based on their language (e.g. "french"). Multiple values allowed, use coma as a separator (e.g. "english,french").
    lang_limit int Number of elements to display in the language facet (default: 10).
    For example, using the LOV Search Vocab API, your app can search for all vocabulary in English matching the term "Time": http://lov.okfn.org/dataset/lov/api/v2/vocabulary/search?q=time&lang=English
  • get/api/v2/vocabulary/autocomplete

    Autocomplete Vocab API v2
    The Autocomplete Vocab API allows a user to get autocompletion recommendations for vocabularies in Linked Open Vocabularies ecosystem. The autocompletion is performed on vocabulary URI (e.g. http://www.w3.org/2003/01/geo/wgs84_pos) or vocabulary prefix (geo). The user can ask for autocompletion from 1 character.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    page_size int Maximum number of results to return per page (default: 10).
    For example, using the Autocomplete Vocab API, your app can search for all vocabularies with URI or Prefix begining with "geo": http://lov.okfn.org/dataset/lov/api/v2/vocabulary/autocomplete?q=geo
  • get/api/v2/vocabulary/info

    Info Vocab API v2
    The Info Vocab API allows a user to get details about one vocabulary.
    Parameter Type Description
    vocab string Prefix, URI or Namespace of a vocabulary in LOV. This parameter is mandatory
    For example, using the Info Vocab API, your app can get the deatils about schema.org vocabulary: http://lov.okfn.org/dataset/lov/api/v2/vocabulary/info?vocab=schema
Agent
  • get/api/v2/agent/list

    List Agent API v2
    The List Agent API allows a user to list all agents (Person or Organization) in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    - - -
    For example, using the List Agent API, your app can list all agents in LOV: http://lov.okfn.org/dataset/lov/api/v2/agent/list
  • get/api/v2/agent/search

    Search Agent API v2
    The Search Agent API allows a user to search over Linked Open Vocabularies ecosystem for an agent (person or organization).
    Parameter Type Description
    q string Full text query.
    page_size int Maximum number of results to return per page (default: 10).
    page int Result page to display starting from 1 (default: 1).
    type string Filter query results based on their type. Possible values: [person, organization].
    tag string Filter query results based on their tag (e.g. "event"). Multiple values allowed, use coma as a separator (e.g. "event,time").
    tag_limit int Number of elements to display in the tag facet (default: 10).
    For example, using the LOV Search Agent API, your app can search for all person having a name containing "Pierre": http://lov.okfn.org/dataset/lov/api/v2/agent/search?q=Pierre&type=person
  • get/api/v2/agent/autocomplete

    Autocomplete Agent API v2
    The Autocomplete Agent API allows a user to get autocompletion recommendations for agents (Person or Organization) in Linked Open Vocabularies ecosystem. The autocompletion is performed on agent name (e.g. Food and Agriculture Organization) or agent URI (e.g. http://lov.okfn.org/dataset/lov/agents/Food%20and%20Agriculture%20Organization). The user can ask for autocompletion from 1 character.
    Parameter Type Description
    q string URI or prefixed URI to complete (from 1 character).
    For example, using the Autocomplete Agent API, your app can search for all agents with name or URI including "bern": http://lov.okfn.org/dataset/lov/api/v2/agent/autocomplete?q=bern
  • get/api/v2/agent/info

    Info Agent API v2
    The Info Agent API allows a user to get details about one agent in LOV.
    Parameter Type Description
    agent string URI, AltURI or FullName (as stated in LOV) of an agent in LOV. This parameter is mandatory
    For example, using the Info Agent API, your app can get the details about W3C agent: http://lov.okfn.org/dataset/lov/api/v2/agent/info?agent=W3C