Use the Identity Match API to map between Shareaholic UUIDs and your user IDs

Reliable, customizable, and fast to help you grow your brand.

User ID Match API

API Designed for Ease

All API methods are accessible via simple HTTP calls. We have optimized for ease of implementation, so you won’t see anything complicated. Most implementations of this API take less than 15 minutes to setup. Simply call the provided URLs with their respective parameters, and you're done.

Getting Started: Authentication

In order for you to use this service, we need to whitelist your redirect URL (r). If you're interested in using this service, please contact your Shareaholic contact or contact us.

Parameters

Endpoint: https://pixel.shareaholic.com/sync/

Parameter Description Required? Example
r Redirect URL Required r=https://www.yourdomain.com/?id=$u_id (should be URL-encoded)

Upon receiving the request for the tag from the user's browser, the service issues a 302 redirect to the specified redirect URL (r). This 302 redirect includes the Shareaholic UUID ($u_id). We recommend storing the exact string returned by the Identity Match service in your match table.

Working Example:

For example, you could supply the following redirect URL (r):

https://pixel.shareaholic.com/sync?r=https://example.com/partners_api?partner_uid=$u_id

The service would then redirect to a URL (r) like this:

https://example.com/partners_api?partner_uid=123456789

(This 302 redirect includes the Shareaholic UUID, which in this example is 123456789)

Build with Shareaholic

Developer Tools and APIs that are reliable, stable, and fast. Built and run on the same scaled cloud infrastructure that runs Shareaholic products and powers functionality across over 300,000+ sites. Over 10 years in production.

As featured on