How to access the API:
AuthenticationThe authentication used for this Web API is
Basic Authentication. The same credentials are used as the "Trendstop" website.
See Basic access authentication (on wikipedia) for more information.
If no credentials are supplied using the
Authorizationheader or the credentials are incorrect, the HTTP status code
401(Unauthorized) will be returned.
API KeyEvery request must contain the
X-AuthKeyheader with the key for your application.
Alternatively you can add the key to the querystring, the name should be
Contact Biblo for information about obtaining a key.
If no key is supplied or the key is invalid the HTTP status code
403(Forbidden) will be returned.
ClientTo test this web API, you can use Postman - REST Client for Google Chrome, the RESTClient for Firefox, Fiddler for Windows or any other REST/HTTP client. Don't forget to set the authentication and the API key headers.
These lists should be stored within you application and fetched only when a value is missing from retrieved company data (ie new sector or figure code).
List of Trendstop Sectors.
List of Nacebel.
List of available figures.
List of functions for the management.
Returns 404 when company data is not available in Trendstop.
Company details with vat parameter (ie 439307357 for Biblo).
Rating is expressed as a value from 1 to 5; or null if unknown.
Ranking by turnover and added value in country and in sector.
Management: board members and executives.
Key figures (possible data).
Ratios (possible data).
Social balance sheet (possible data).
Search Company / Companies
The maximum number of results returned is 20.
Search for companies by name.
Search for companies by name at the given location (postalcode or city).
Get the remaining credit count (and total initial credits).
Consume count credit(s). Will return the remaining credit count.
Get current API usage rate limit.
Accept header is used to determine the media type for the response.
This header is optional, and if ommited then JSON is return.
Alternatively you can add the extension
.xml to the request. Example of getting sectorlist as json:
Accept-Language header is used to determine the language. Querystring
l can also be used. These 3 language codes are accepted:
ENfor English (limited support)
An account can have a number of export credits. These should be consumed when importing data into the calling application. This is part of the license/agreement attached to the API key.
About Rate Limit
Every response contains headers with the limit, remaining calls and seconds until
reset. These headers are:
Because the response can be cached, the headers might not contain the current values.
/api1/ratelimit resource for the current values.
When the limit has been reached, the HTTP status code
429 (Too Many Request)
will be returned. An extra header
Retry-After will be added, containing
the number of seconds until the counter is reset.
The default limit is currently set to 200 requests an hour per login.