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

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

## API Designed for Ease [Anchor](/content/api/match#api-designed-for-ease/index.html)

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 [Anchor](/content/api/match#getting-started-authentication/index.html)

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](/content/contact/index.html).

## Parameters [Anchor](/content/api/match#parameters/index.html)

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`):

```html
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:

```html
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.