How to effectively use the OpenCorporates Reconciliation API?

Question

How to use the opencorp API? For instance

According to the website:

The Open Refine Reconciliation API allows OpenRefine users to match company names to legal corporate entities. This is especially useful when you have an existing spreadsheet or dataset featuring lots of companies. Matching (or reconciling) to legal entities allows you to get more information about the companies (for example the registered address or statutory filings), and makes it easier to match with other datasets or exchange with other organisations.

Following the documentation : Documentation

I can run a GET query in postman for something like this:

https://opencorporates.com/reconcile/suggest?prefix=AMAZON

or even search for companies within specific regions.

This is quite good and useful in individual cases but I have 2 questions.

1) How can I generalize this to larger sets of data.

2) Accoring to the website it also says:

Matching (or reconciling) to legal entities allows you to get more information about the companies (for example the registered address or statutory filings).

How do I access this information?

The responses from the GET featured in the documentation don't show this information.

Answer 1

The reconciliation API implemented by OpenCorporates is specified by OpenRefine on its wiki .

To reconcile larger datasets you should use the multiple queries mode, as follows:

https://opencorporates.com/reconcile?queries={%22q0%22%3A{%22query%22%3A%22cambridge%20analytica%22},%22q1%22:{%22query%22:%22mossack%20fonseca%22},%22q2%22:{%22query%22:%22danske%20bank%22}}

Here is a readable version of the queries parameter in the request above:

{
  "q0": {
    "query": "cambridge analytica"
  },
  "q1": {
    "query": "mossack fonseca"
  },
  "q2": {
    "query": "danske bank"
  }
}

To retrieve more information from the records returned by the reconciliation API you will need to use their REST API , as their reconciliation endpoint does not support the Data Extension API specified by OpenRefine so far. You will need to get an API key for that, if you want to use it on more than a few records.

Answer 2

Use OpenRefine: it has all that you asked for and a lot more, and rewriting it would not be effort well spent.
Fix your permission problems.