This is a simple translation layer between Google's Knowledge Graph Search API and (a subset of) the Reconcilation Service API standard. It's implemented as a proxy server using Flask.
- Clone this repository and install the requirements using
pip install -r requirements.txt
, preferably using a virtual environment. - Fill in the environment variable
GKG_API_KEY
in.env
with a valid API key for the Knowledge Graph Search API. - Run the server with
flask run
. - Treat the local server (at
http://localhost:5000
by default) as if it was a reconciliation service endpoint, making requests using a client like OpenRefine or reconciler. Requests will be translated and sent to the Google API.
At present the server only implements the following parameters from the Reconciliation Service API standard for requests: query
, type
and limit
. All returned results are treated as successful matches and the optional features
array is not provided in responses.
The server can easily be deployed to the internet as an AWS Lambda function using the Serverless framework. An example serverless.yml
file is provided.