There are a few API endpoints in Semantic Builders exposed for your convenience.
The following endpoints can be used at no charge.
Available endpoints:
GET https://semantic.builders/api/probe
To just test the authentication key given in the X-SB-Key
header.
If valid, returns a simple feedback payload.
{
"code": 200,
"message": "OK"
}
Error codes:
Semantic Builders exposed a simple API to access your Saved Queries and Extractions.
The following endpoints can be used at no charge.
Available endpoints:
GET https://semantic.builders/api/extracts
To access the list of your extractions. This returns a JSON array, containing a JSON object for each query.
[
{
"id": "ee8b2837-62c4-4be0-8aba-969e4b118a03",
"title": "My Extraction",
"created_at": "2025-04-12T04:58:14",
"size": 6712080
},
{
"id": "5318480e-ccc9-4fb8-b45b-c1c8f4747131",
"title": "My Other Extraction",
"created_at": "2025-04-08T03:52:14",
"size": 203848
}
]
Each extraction is described by:
Error codes:
GET https://semantic.builders/api/extracts/ID
To access the actual contents of a given extraction, identified by the id
(provided by the listing endpoint).
Contents are returned in CSV.
Q1868,"Paul Otlet",+1868-08-23T00:00:00Z,+1944-12-10T00:00:00Z
Q23,"George Washington",+1732-02-22T00:00:00Z,+1799-12-14T00:00:00Z
Q42,"Douglas Adams",+1952-03-11T00:00:00Z,+2001-05-11T00:00:00Z
Q368,"Augusto Pinochet",+1915-11-25T00:00:00Z,+2006-12-10T00:00:00Z
Error codes:
Semantic Builders provides an API to handle arbitrary texts and retrieve named entities from Wikidata, ready to be referenced within text's self metadata.
Each call to the following endpoints is individual charged accordly to the given pricing for the service.
Available endpoints:
GET https://semantic.builders/api/entities
Parameters:
To analyze a text and retrieve references to Wikidata entities. This returns a JSON array, containing a JSON item for each identifier named entity.
[
{
"entity": "Japan",
"wikidata": "https://www.wikidata.org/wiki/Q17"
},
{
"entity": "Tokyo",
"wikidata": "https://www.wikidata.org/wiki/Q1490"
},
{
"entity": "Sapporo Snow Festival",
"wikidata": "https://www.wikidata.org/wiki/Q929531"
}
]
Each item in response is described by:
Error codes: