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: https://stics.iot.linkeddata.es/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:": https://stics.iot.linkeddata.es/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": https://stics.iot.linkeddata.es/dataset/lov/api/v2/term/suggest?q=preson

  • get/api/v2/term/search/metadata

    Metadata Term API v2
    The Metadata Term API allows a user to get metadata about one term in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    q string URI, AltURI or FullName (as stated in LOV) of a term in LOV. This parameter is mandatory.
    For example, using the Metadata Term API, your app can get the metadata about the term "Schedule" in LOV:https://stics.iot.linkeddata.es/dataset/lov/api/v2/term/search/metadata?q=Schedule
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: https://stics.iot.linkeddata.es/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": https://stics.iot.linkeddata.es/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": https://stics.iot.linkeddata.es/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: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/info?vocab=schema

  • get/api/v2/vocabulary/distributions_all

    Distribution API v2
    The Distribution API allows a user to list all distributions Linked Open Vocabularies ecosystem.
    Parameter Type Description
    - - -
    For example, using the LOV Search Distribution API, your app can search for all distributions in LOV https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/distributions_all
Artefact

  • get/api/v2/vocabulary/:artefact/distributions

    Distribution Artefact API v2
    The Distribution API allows a user to list all distributions about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    vocab string Prefix, URI or Namespace of a vocabulary in LOV. This parameter is mandatory. The inserted vocabulary is equivalent to :artefact.
    For example, using the Distribution Artefact API, your app can list all distributions about a vocabulary LOV: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/distributions?vocab=s4grid

  • get/api/v2/vocabulary/:artefact/distribution/latest

    Latest Artefact Distribution API v2
    The Latest Distribution API allows a user to get the latest distribution about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    vocab string Prefix, URI or Namespace of a vocabulary in LOV. This parameter is mandatory. The inserted vocabulary is equivalent to :artefact.
    For example, using the Latest Distribution API, your app can list the last distribution about a vocabulary LOV: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/distributions/latest?vocab=s4grid

  • get/api/v2/vocabulary/:artefact/distribution/:distributionID

    Distribution ID API v2
    The Distribution ID API allows a user to get a specific distribution about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Linked Open Vocabularies ecosystem. This parameter is mandatory and a path parameter.
    :distributionID string ID of the distribution. This parameter is mandatory and a path parameter.
    For example, using the Distribution ID API, your app can a distribution about a vocabulary LOV: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/s4grid/distributions/s4grid_v2

  • get/api/v2/vocabulary/:artefact/resources

    Vocab Resources API v2
    The Vocab Resources API allows a user to list all resources about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Linked Open Vocabularies ecosystem. This parameter is mandatory and a path parameter.
    For example, using the Vocab Resources API, your app can list all resources about a vocabulary LOV: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/s4grid/resources

  • get/api/v2/vocabulary/:artefact/resources/:resourceID

    Vocab Resource ID API v2
    The Vocab Resource ID API allows a user to get the resource ID about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Linked Open Vocabularies ecosystem. This parameter is mandatory and a path parameter.
    :resourceID string ID of the resource. This parameter is mandatory and a path parameter. The query only works when its prefix and suffix are passed as parameters in :resourceID. Example: s4grid:DaySchedule.
    For example, using the Vocab Resource ID API, your app can list all resources from a specific resource about a vocabulary LOV: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/s4grid/resources/s4grid:DaySchedule

  • get/api/v2/vocabulary/:artefact/resources/type/class

    Vocab Resource Classes API v2
    The Vocab Resource Classes API allows a user to list all classes about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Linked Open Vocabularies ecosystem. This parameter is mandatory and a path parameter.
    For example, using theVocab Resource Classes API, your app can list all classes about a vocabulary Linked Open Vocabularies ecosystem: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/s4grid/resources/type/class

  • get/api/v2/vocabulary/:artefact/resources/type/property

    Vocab Resource Properties API v2
    The Vocab Resource Properties API allows a user to list all properties about one vocabulary in Linked Open Vocabularies ecosystem.
    Parameter Type Description
    :artefact string Prefix, URI or Namespace of a vocabulary in Linked Open Vocabularies ecosystem. This parameter is mandatory and a path parameter.
    For example, using the Vocab Resource Properties API, your app can list all properties about a vocabulary Linked Open Vocabularies ecosystem: https://stics.iot.linkeddata.es/dataset/lov/api/v2/vocabulary/s4grid/resources/type/property
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: https://stics.iot.linkeddata.es/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": https://stics.iot.linkeddata.es/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. https://stics.iot.linkeddata.es/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": https://stics.iot.linkeddata.es/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: https://stics.iot.linkeddata.es/dataset/lov/api/v2/agent/info?agent=W3C