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

We have optimized for ease of implementation. All API methods are accessible via simple HTTP calls. 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 rock solid years in production.

As seen in