Welcome to Sparklane API

Discover Sparklane API and retrieve the complete informations about companies. Sparklane API provides advanced features to search, score and follow live companie's news. Find more than 10 millions companies accross multiple countries.

Prerequisite

Access

Sparklane API is a private API. To sign up and get your access key, please contact the Sparklane sales team. Also, to retrieve your access restrictions, please refer to your sales conditions.

Getting started

Sparklane API implements REST protocol based on HTTPs. Basicly, you can use curl in shell command. Of course, you can also use any HTTP client in your favorite language.

To validate network connections, run the first simple command :

curl -I https://api.sparklane.fr/v5/status

You should obtain a success response code (ie. 200).

Authentication

Sparklane API is based on Basic Auth authentication method. This standard describes the way to provide username and password in request's header. When you open your API account, Sparklane will give you your username, password and the token to use (the base64 encoding of id and password). In each API request, you must provide this token in Authorization header.

To validate your token, run this simple command (replacing by your token) :

curl -I -H "Authorization: Basic YOUR_TOKEN" https://api.sparklane.fr/v5/check_token

You should obtain a success response code (ie. 200).

Troubleshooting

Sparklane API implements standards HTTP status codes. A 2xx response code means that the request is successful. In the others cases, please refer to the HTTP specification to understand your result code.

Common errors

Error Description
401 - Unauthorized Set the header "Authorization: Basic YOUR TOKEN"
401 - Invalid authentication credentials Your token is not available: check that you don't make mistake copying it
403 - You cannot consume this service Your token is validated but you're not allowed to access to this service
429 - Too Many Request You sent too many requests related to your usage conditions
5xx - Internal Server Error The Sparklane API is encoutering a technical problem: you could retry in a few minutes

In any case, if you need help, you could contact the Sparklane support team.