What is Shopello API?

Hundreds of stores and millions of products are collected in Shopello API that allow customers to integrate and list products in various ways

How to get access to the Shopello API:

1. Apply to become a Shopello partner here: https://www.shopelloapi.com/
2. Once approved, you get a unique API key which gives access to the API
3. You'll also get login information to your own partner interface where you can view statistics and your revenue

Get access to online retailers and their products through Shopello API. Integrate them easily on your site or in your web service and get revenue for all the clicks generated from the products. It's quick to apply for an API key and if your site is relevant it will be approved quickly. The Shopello API also have ready solutions such as widgets, banners, white label and even a Wordpress plugin so you can easily create product listings in Wordpress. You will obtain technical support directly from our experts when implementing the API. In our documentation, you will find guides and help to integrate the products easily. For feedback and questions please contact us at [email protected].

New design released 2019-05-25

Feel free to contact us if you have any feedback.

Depreciation of product price history 2017-08-09

This part of the API will be removed within the upcoming weeks.
If you depend on this API endpoint we recommend that you store this information locally.

New product attributes 2017-07-04

We added four new product attributes; Color, Size, Gender and GTIN.

Feeds and products now available at Datafeedr 2016-06-27

All feeds and products from Shopello are now available for Datafeedr. If you use Wordpress or plan to now you got all our products available in their plugins to create awesome ecommerce sites.

Deeplink enabled and disabled stores 2016-06-07

It's now possible to retrieve all enabled and disabled deeplink stores. Please check https://docs.shopelloapi.com/#Deeplink-enabled-storese> section for more information.

Shipping cost and stock in Product Search API and Static Feeds

Shipping cost and stock values is now available. For the Product Search API please check the "attributes" field and for Static feeds new fields are added <ShippingCost> and <stock>. Beware of that the data is not always available, the data is only imported for those that have this information.
Field values:
Shipping cost: 0 for free shipping cost and > 0 is amount of cost for shipping
Stock: 0 for not in stock and 1 for in stock and empty for unknown.

Store status log 2016-03-30

It's now possible to get a status log for stores when they are added, activated and inactivated.

Partners can now set an URI for channels 2016-03-15

The purpose of this field is mainly for statistics purposes to make it possible to detect from which site/user the traffic from and to specific places comes.

Partners that make heavy use of channels should try to set the URI field of all their channels. This can be done with both an update method and also on creation of a channel.

Atom feed available for news 2015-11-25

Since today there's an atom-feed available for these news articles. You can find it at https://docs.shopelloapi.com/atom.xmle> and subscribe with your feedreader of choice.

Category filter on static feeds 2015-10-27

It's now possible to filter on categories in static feeds, for the moment it's only possible to exclude categories. You can find more info here: https://docs.shopelloapi.com/#Static-Feedse>

Keyword mapping tool in partner admin 2015-10-26

It's now possible to make your own keyword mapping to optimize your earnings.
You can easily map keyword to keyword, keyword to one or more categories or map to both keyword and categories. Matching types is also introduced for exact matching, start with, end with or broad matching.

Revenue Segment in API 2015-10-09

We added a field on all products in the API-Result named revenue_segment with can contain one of the following three strings: low, medium or high.

This approximates the revenue from clicks on this product. The limits of how this segment is calculated might change in time. These changes will be minor and will be done to balance so the three segments will be approximately the same size.

Old deeplink solution depricated

The old deeplink solution is now depricated and will stop working 2015-10-30. Please make sure to use the deeplink generator as soon as possible.

Channel management in partner admin 2015-08-11

We have now optimized (made it faster) the statistics in channel management page and possibility to filter statistics by date range.

It's now possible to add multiple uris in one singel request. Se section: https://docs.shopelloapi.com/#Deep-Link-Generator of the documentation to see the guidelines.

Support for multiple uris in deeplink generator 2015-07-31

It's now possible to add multiple uris in one singel request. Se section: https://docs.shopelloapi.com/#Deep-Link-Generator of the documentation to see the guidelines.

Widget generator 2015-07-02

We added a public tool for creating widgets that you can include into your website. It is somewhat context sensetive, it reads the ?q= parameter and looks for the first <h1> in the page. But it also accepts queries so you can provide your own query-string.

You can find the widget-generator here: https://docs.shopelloapi.com/widget_generator

Fetch Revenue for all channels at once 2015-05-07

Using the string all as {channel_id} will return a list of all channels and their revenue. The key in this list is the {channel_id}.

New click-page live 2015-04-07

We released a new landingpage for clicks today which is part of the new API. The old API and Static Feeds is ported to use this as well, so everyone benefits from it. All the URI's in the new API is signed using our PHP-Library SignUri found here.

The links contains a GET-Parameter named clickdata, do not try to change this, it will end up as an Invalid Link.

As a partner, you can add your own signed data to the link to prevent users and others to alter this data before it is sent to us. At the moment, the only data you can add and sign is channel.

Examplecode:

<?php

require('vendor/autoload.php');

$signUri = new \Shopello\API\SignUri();

$uri = $signUri->signUri(
    '<link that we provide from API or static feeds>',
    '<pre-shared secret>',
    'partnerdata',
    array(
        'channel' => '<channel id of choice>'
    )
);

The pre-shared secret is available through the API from today. If you lost your secret and want a new one, we added a method for that in the API as well. Be aware that changing your secret will break old links that you have signed on your own.

APIv3 is taking shape 2015-03-24

The documentation is already written and available here. The PHP API-Client also supports this new version of the API. (It's a separate class named Api3Client).

Please note changes in authentication, it uses your username/password to the Partneradmin instead of API-Key due to the availability to sensitive information such as statistics and admin possibilities of channels in the API.

Wordpress plugin 2015-03-03

New release of our Wordpress plugin. You can download it here https://wordpress.org/plugins/shopello

Shopello PHP Client 2015-03-03

Current buildstatus of the client:

We released a new Shopello client written in PHP. It's available on github here: https://github.com/Shopello/Shopello-PHP

The client is straightforward to use and the preferred way to install it is to use composer. But since we're not in the main repositorys of composer you have to add the repository to your composer.json by hand. You can read more about this in the README on the project page on github.