ltrgoddard / reconcile-gkg

API proxy providing a Reconciliation Service API endpoint for Google Knowledge Graph

reconcile-gkg

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.

Usage

1. Clone this repository and install the requirements using pip install -r requirements.txt, preferably using a virtual environment.
2. Fill in the environment variable GKG_API_KEY in .env with a valid API key for the Knowledge Graph Search API.
3. Run the server with flask run.
4. 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.

Limitations

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.

Deployment

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.