Affiliate Links

Create or update up to 500 links in one call, matched on link_key. Use this to sync all products at once, e.g. one link per product with link_key = the product slug and target_url = its affiliate URL. Only https:// URLs. Sending an existing link_key replaces its target_url, label, group and is_active.

Change one link. Only send what changes. Send an empty string for label or group to clear it. is_active false stops the link (the page should then fall back to your own product page).

Delete one link and its click counts permanently. To pause it instead, use update-link with is_active false.

All links with their total clicks and clicks in the last 30 days. Paginated, optionally filtered by group or a search on link_key/label.

How clicks are counted for this project. Only send what changes. Abuse limits only stop COUNTING — visitors are always sent to the shop.

The counting settings of this project, the number of links and the platform limits.

No input parameters required.

Counted clicks over a date range (UTC days, default the last 30 days, max 366), grouped by link, day, group, source or page. Optionally for one link_key or group.

A visitor clicks an affiliate link. Returns {url, counted}: always the stored URL of that link — send the visitor there. counted is false when the click was a repeat or over the abuse limit; the visitor is still sent on. Page pattern: give the <a> an href to your OWN product page (fallback without JavaScript) and a data-link-key. On click: preventDefault; for a new tab call window.open("", "_blank") synchronously FIRST (otherwise popup blockers block it after the await), then POST to /sapi/project/{id}/execute/affiliate-links/click with {link_key, source, page: location.pathname} and set that tab's location to the returned url. If the call fails, keep the fallback href. Unknown or inactive link: error, use the fallback.