European Company Explorer Platform
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
api
index
.gitignore
README.md
pom.xml

README.md

ECEP - European Company Explorer Platform

The open data project by Implisense funded by ODINE. With ECEP you are able to search for any arbitrary company properties on company websites in Europe. Analyze and compare the latest company trends in different regions and industries. The beta version is now available for United Kingdom.

You can test it online at https://ecep.implisense.com/. There we have an installation, which is filled with company and web data and ready to answer your queries.

Installation

You can also set up your own installation of our software. It needs a running Elasticsearch installation. If you don't already have one, you can simply set it up and run it like that:

wget https://download.elastic.co/elasticsearch/release/org/elasticsearch/distribution/zip/elasticsearch/2.3.4/elasticsearch-2.3.4.zip
unzip elasticsearch-2.3.4.zip
./elasticsearch-2.3.4/bin/elasticsearch

To get the ECEP software, just clone this repository or download a snapshot as a zip file and unzip it:

wget https://github.com/implisense/ecep/archive/master.zip && unzip master.zip

This creates the directory ecep-master with the project files. We go there and install the artifacts into the local maven repository:

cd ecep-master
mvn install

For support of geographical data simply download http://www.doogal.co.uk/files/postcodes.zip and place it into the api directory:

cd ecep-master/api
wget http://www.doogal.co.uk/files/postcodes.zip

Now we are ready to start the application:

mvn exec:java

This creates an empty ecep index in the local elasticsearch installation and starts an HTTP-Server listening on port 8061. Now we can put the companieshouse data into the index:

wget http://download.companieshouse.gov.uk/BasicCompanyData-2016-11-01-part1_5.zip
curl -XPOST --data-binary "@BasicCompanyData-2016-11-01-part1_5.zip" http://localhost:8061/data/companies

You might want to do this for all five files (simply exchange the suffix). Now we have set up everything to query the API:

POST http://localhost:8061/search
{
    "query": "design",
    "sicCode": "13.93",
    "postCode": "SA73 3JP",
    "category": "Private Limited Company"
}

Or via curl:

curl -X POST -H "Content-Type: application/json" -d '{
    "query": "design",
    "sicCode": "13.93",
    "postCode": "SA73 3JP",
    "category": "Private Limited Company"
}' "http://localhost:8061/search"

License

Copyright 2016 Implisense GmbH

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

ECEP is maintained by Implisense and funded by ODINE.

Implisense

The Implisense GmbH is a technology company with headquarters in Berlin. The company is one of the technologically leading suppliers of sales intelligence for B2B. We love open source software and are hiring!

ODINE

The Open Data Incubator for Europe (ODINE) is a 6-month incubator for open data entrepreneurs across Europe.