Web Service Method: Request the Trend History of Concepts

Description

Requests the trend history of multiple concepts

URL: /GraphSearch/api/trend/histories

Request

Supported Methods

GET

HTTP Parameters

Parameter

Comment

Type

Required

searchSpaceId

ID of the search space

String

true

concepts

Comma separated list of URIs of requested concepts

List of URIs

true

Response

This method returns execution results in JSON format.

Array of ConceptTrend

Attribute

Type

Comment

concept

Concept

Trend concept

trend

Array of longs

Trend values

Example of Response Attribute ConceptTrend
{
  "trend" : [ { }, { } ],
  "concept" : {
    "score" : 5709,
    "topConcepts" : [ "https://semantic-web.com/api/topConcepts#1760", "https://semantic-web.com/api/topConcepts#5789" ],
    "inScheme" : [ "some inScheme" ],
    "label" : "some label",
    "transitiveBroaders" : [ "some transitiveBroaders", "some transitiveBroaders", "some transitiveBroaders" ],
    "uri" : "https://semantic-web.com/api/uri#22455"
  }
}
Concept

Attribute

Type

Comment

prefLabel

String

PrefLabel

uri

String

Uri

score

Integer

Score

inScheme

Array of Strings

InSchemes

topConcepts

Array of Strings

TopConcepts

transitiveBroaders

Array of Strings

TransitiveBroaders

Example of Response Attribute Concept
{
  "score" : 22951,
  "topConcepts" : [ "https://semantic-web.com/api/topConcepts#16171" ],
  "inScheme" : [ "some inScheme" ],
  "label" : "some label",
  "transitiveBroaders" : [ "some transitiveBroaders" ],
  "uri" : "https://semantic-web.com/api/uri#31171"
}

Note

The return to this request will display these errors in the following specific cases:

  • If the Search Space ID is wrong, you will receive a 404 'Bad Request' message, with specific information in a JSON message as to the value that was not found.

  • If the credentials were mistyped or wrong: a 403 Forbidden, and a JSON message 'Access denied' will be returned.

  • If you didn't specify a Search Space ID: the return will be made for the default Search Space.

    • If the default Search Space is private and you are not authenticated, you will also receive a 403 Forbidden in a JSON message.