Connecting Beslist on Clarisights
Beslist.nl is the largest online shopping mall in the Netherlands, aggregating products from thousands of online shops. Connecting Beslist to Clarisights brings your daily shop-stats — clicks and click costs by product category and brand — into your performance reporting alongside other paid channels.
At a glance
| Authentication | OAuth2 client credentials (Client Key + Client Secret) issued by Beslist |
| Permissions needed | Beslist Statistics API access enabled by your Beslist account manager |
| Account discovery | Single shop per credential — one Beslist account is created automatically on connect |
| Data freshness | Daily |
| Lookback window | Last 7 days on every refresh |
| Backfill on connect | Last 7 days |
| Timezone | Europe/Amsterdam |
| Currency | EUR |
| Levels supported | Account · Campaign (per-product / per-category) |
| Limited rollout | Yes — existing Beslist customers only; new accounts cannot be added self-serve. Contact Clarisights support to enable. |
Prerequisites
An active Beslist.nl shop
Statistics API access enabled by your Beslist account manager — email your account manager and request access to the Beslist Statistics API
A Beslist Client Key and Client Secret issued for your shop
Steps to Connect
Step 1 — Request API credentials from Beslist
Contact your Beslist account manager and request access to the Statistics API. Beslist will issue you a Client Key and Client Secret scoped to your shop. Copy both values — you will paste them into Clarisights in Step 3.
Treat your Client Secret like a password. It grants read access to your Beslist shop statistics.
Step 2 — Open Beslist in Clarisights
In Clarisights, go to Integrations → Beslist.
[TODO: Screenshot needed — Integrations page Beslist row]
⚠ "Add Account" button is missing or disabled → New Beslist accounts cannot be added self-serve. If you are an existing Beslist customer migrating from another setup, contact Clarisights support to enable the connection on your behalf.
Step 3 — Enter credentials
Paste your Client Key and Client Secret, then submit the form. Clarisights exchanges them with Beslist for an access token and creates the Beslist ad account automatically.
[TODO: Screenshot needed — Beslist credentials form]
⚠ "Could not fetch token" / token error on submit → Double-check the Client Key and Client Secret. Beslist returns this when either value is wrong or when Statistics API access has not yet been enabled for your shop. Verify with your Beslist account manager that API access is provisioned, then retry.
Verify the connection
Go to Integrations → Beslist. Your shop should appear with a "Connected" status.
First data appears within ~24 hours (Beslist data syncs daily).
Quick start: create a new report, add Beslist as the data source, and add Account · Category · Clicks · Cost.
Data available
Hierarchy
Beslist has a flat data model — statistics are returned per shop, per day, broken down by product, category, and brand. There is no native concept of campaigns or ad groups. Clarisights normalizes this into the standard hierarchy as follows:
Native level (Beslist) | Clarisights level |
Shop | Account |
Product / Category / Brand row | Campaign (Beslist has no native Campaign / Ad Group / Ad — rows are stored at the Campaign level with category and brand as attributes) |
Dimensions
Dimension | Level | Description |
Account | Account | Beslist shop name |
Category Name | Campaign | Beslist product category name |
Category ID | Campaign | Beslist product category ID |
Category Type | Campaign | Beslist category classification |
Brand Name | Campaign | Brand of the product as classified by Beslist |
Brand ID | Campaign | Beslist brand ID |
URL | Campaign | Destination URL Beslist sent traffic to |
Metrics
Metric | Description |
Clicks | Total clicks Beslist delivered to your shop |
Cost | Total CPC cost charged by Beslist, in EUR |
Limitations & known constraints
Existing accounts only: New Beslist integrations cannot be added self-serve from the Integrations page (the "Add Account" button is disabled). Existing Beslist connections continue to work normally; contact Clarisights support if you need to onboard a new Beslist shop.
Single shop per credential: A Client Key / Client Secret pair is scoped to one Beslist shop. To connect multiple shops you need separate credentials per shop.
No campaign / ad-group / ad level: Beslist does not expose a campaign concept. All performance data is per-product / per-category, stored at the Campaign level in Clarisights.
Two metrics only: Beslist's Statistics API exposes clicks and cost. Impressions, conversions, and revenue are not available.
Daily granularity: Beslist provides one row per shop per day — no hourly breakdown.
EUR only: Cost is reported in EUR. Clarisights converts to your reporting currency on ingest.
7-day pull window: Each refresh pulls the last 7 days of data. Older data is not back-pulled automatically; contact support for longer historical backfills.
Operating notes
Refresh schedule: daily.
Lookback: last 7 days re-pulled on every refresh, so late-arriving Beslist updates are picked up automatically.
Multi-account: each Client Key / Client Secret connects exactly one Beslist shop. Connect additional shops with separate credentials.
Currency conversion: Beslist reports in EUR; Clarisights converts to your reporting currency on ingest.
Token rotation: access tokens are short-lived and refreshed automatically by Clarisights using your Client Key / Client Secret — no manual rotation required.
Credential rotation: if you rotate your Client Secret in Beslist, contact Clarisights support to update the stored credentials.
Need help?
When contacting support from the in-app messenger, please include:
The integration name and shop name (Integrations → Beslist)
The exact error message or screenshot
The step where the issue occurred
When the issue started