Api Common Searches

First, see common parameters to know how to build queries.

search a domain by name

curl -i -X GET http://epnoi.org/api/domains?name=iswc*

Sample Response:

{
	"domains": [
		{
			"uri": "domains/133203",
			"name": "iswc2015"
		},
		{
			"uri": "domains/132200",
			"name": "iswc2014"
		}
	]
}

read details of a domain

curl -i -X GET http://epnoi.org/api/domains/133203

Sample Response:

{
	"uri": "domains/133203",
	"name": "iswc2015",
	"description": "Papers from the 14th International Semantic Web Conference",
	"documents": 67,
	"topics": 8,
	"terms": 1123,
	"entities": 776,
	"relations": 161
}

list of documents in a domain

curl -i -X GET http://epnoi.org/api/documents?domain=133203

Sample Response:

{
	"documents": [
		{
			"uri": "documents/223921133",
			"name": "Variational Harmonic Maps for Space Deformation"
		},
		{
			"uri": "documents/400921102",
			"name": "Toward clearer skies: Challenges in regulating transboundary haze in Southeast Asia"
		}
	]
}

list of topics discovered in a domain

curl -i -X GET http://epnoi.org/api/topics?domain=133203

Sample Response:

{
	"topics": [
		{
			"uri": "topics/19374273",
			"sample": "graphic,computer,category,capture,processing,realism"			
		},
		{
			"uri": "topics/19374512",
			"sample": "color,illumination,polarization,video"
		}
	]
}

list of organizations discovered in a domain

curl -i -X GET http://epnoi.org/api/words?domain=133203&type=organization

Sample Response:

{
	"words": [
		{
			"uri": "words/19374273",
			"name": "Universidad_Politecnica_Madrid"
		},
		{
			"uri": "words/2239991223",
			"name": "Ontology_Engineering_Group"
		}
	]
}

list of semantic relations discovered in a domain

curl -i -X GET http://epnoi.org/api/relations?domain=133203&type=semantic

Sample Response:

{
	"relations": [
		{
			"uri": "relations/19374273",
			"describes": "antonymy"
		},
		{
			"uri": "relations/74311293",
			"describes": "homonym"
		}
	]
}

list of terms, sorted by frequency, in a domain

curl -i -X GET http://epnoi.org/api/words?domain=133203&type=term&sort=-times

Sample Response:

{
	"words": [
		{
			"uri": "words/19374273",
			"name": "world",
			"times": 78
		},
		{
			"uri": "words/342210933",
			"name": "sense",
			"times": 72
		}
	]
}

search a document by name

curl -i -X GET http://epnoi.org/api/documents?name=Toward*

Sample Response:

{
	"documents": [
		{
			"uri": "documents/223921102",
			"name": "Toward Evaluating Lighting Design Interface Paradigms for Novice Users"
		},
		{
			"uri": "documents/400921102",
			"name": "Toward clearer skies: Challenges in regulating transboundary haze in Southeast Asia"
		}
	]
}

search the last document added from a source

curl -i -X GET http://epnoi.org/api/documents?source=mySource&sort=-added&limit=1

Sample Response:

{
	"documents": [
		{
			"uri": "documents/437921102",
			"name": "Variational Harmonic Maps for Space Deformation"
		}
	]
}

read the topic distribution of a document in a domain

curl -i -X GET http://epnoi.org/api/documents/437921102?domain=1223443&fields=topic

Response:

{
	"topics": [
		{
			"uri": "topics/125921102",
			"rate": 0.56647
		},
		{
			"uri": "topics/125313229",
			"rate": 0.32234
		}
	]
}

list of documents, sorted by rate, containing a topic

curl -i -X GET http://epnoi.org/api/documents?topic=125313229&sort=-rate

Response:

{
	"documents": [
		{
			"uri": "documents/11022282",
			"name": "ShadowDraw: Real-Time User Guidance for Freehand Drawing",		
			"rate": 0.98647
		},
		{
			"uri": "documents/11022276",
			"name": "Motion Capture from Body-Mounted Cameras",
			"rate": 0.97234
		},
		{
			"uri": "documents/20524282",
			"name": "Exploration of Continuous Variability in Collections of 3D Shapes",
			"rate": 0.90828
		},
		{
			"uri": "documents/437921102",
			"title": "A Versatile HDR Video Production System",
			"rate": 0.78828
		}
	]
}

top ten words of a topic sorted by rate

curl -i -X GET http://epnoi.org/api/topics/2052?fields=words&sort=-rate&limit=10

Response:

{
	"words": [
		{
			"uri": "words/709264",
			"value": "symmetry",
			"rate": 0.38647
		},
		{
			"uri": "words/54413",
			"value": "system",
			"rate": 0.27234
		},
		{
			"uri": "words/823812",
			"value": "algorithm",
			"rate": 0.10828
		},
		{
			"uri": "words/124531",
			"value": "procedure",
			"rate": 0.04291
		}
	]
}

search entities by name

curl -i -X GET http://epnoi.org/api/words?type=place&name=madrid*

Sample Response:

{
	"entities": [
		{
			"uri": "words/709264",
			"name": "madrid"
		},
		{
			"uri": "words/883732",
			"name": "madrid_arena"
		}
	]
}

search domains where an entity appears

curl -i -X GET http://epnoi.org/api/domains?word=709264&sort=-times

Sample Response:

{
	"domains": [
		{
			"uri": "domains/709264",
			"name": "iswc2015",
			"times": 791
		},
		{
			"uri": "domains/54413",
			"name": "siggraph2006",
			"times": 552
		},
		{
			"uri": "domains/823812",
			"name": "acmCCS2015",
			"times": 323
		},
		{
			"uri": "domains/124531",
			"name": "acLing2015",
			"times": 292
		}
	]
}

search items where an entity appears

curl -i -X GET http://epnoi.org/api/items?word=709264&sort=-times

Sample Response:

{
	"items": [
		{
			"uri": "items/709264",
			"title": "Using Sensor Metadata Streams to Identify Topics of Local Events in the City",
			"times": 111
		},
		{
			"uri": "items/54413",
			"title": "StarSum: A Simple Star Graph for Multi-document Summarization",
			"times": 87
		},
		{
			"uri": "items/823812",
			"title": "When Relevance Judgement is Happening? An EEG-based Study",
			"times": 80
		},
		{
			"uri": "items/124531",
			"title": "Search Engine Evaluation based on Search Engine Switching Prediction",
			"times": 25
		}
	]
}

search entities related to a given place (entity) in documents of a domain

curl -i -X GET http://epnoi.org/api/relations?domain=334824&any=709264

Response:

{
	"relations": [
		{
			"uri": "relations/8832773",
			"type": "associative",
			"describes": "capital-of"
		},
		{
			"uri": "relations/54413",
			"type": "associative",
			"describes": "province-of"
		},
		{
			"uri": "relations/823812",
			"type": "associative",
			"describes": "located-in"
		}
	]
}