> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sourcemedium.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Judge.me - Integration Instructions

> Connect Judge.me with an API token to land your product reviews as raw warehouse tables.

> [!NOTE]
>
> Raw data only. Judge.me lands as raw warehouse tables, not modeled dashboards or AI analysis. Raw tables are delivered only to organizations on a dedicated warehouse, for the tables picked under [**Warehouse → Raw data**](https://docs.sourcemedium.com/docs/data-activation/managed-data-warehouse/raw-data.md) in your SourceMedium workspace. See [Foundation and Pro](https://docs.sourcemedium.com/docs/data-activation/managed-data-warehouse/overview.md#foundation-and-pro).

Judge.me is a product review and UGC platform for Shopify. SourceMedium reads your Judge.me reviews and lands them in your warehouse.

## Requirements

* **A connected Shopify store.** Judge.me identifies your shop by its `myshopify.com` domain, and SourceMedium reads that domain from the store's Shopify connection. Connect Shopify for the store first. Until it is connected, SourceMedium does not accept the Judge.me token.

> [!NOTE]
>
> Sign in to [SourceMedium](https://urchin.sourcemedium.com), open your store, then choose **Data sources → Connect data source** and select the platform. You need an **Admin** or **Editor** workspace role.
>
> [After you connect](https://docs.sourcemedium.com/docs/data-inputs/platform-integration-instructions/after-you-connect.md) explains the first sync and connection statuses.

## How to connect

SourceMedium connects to Judge.me with an API token that you copy from Judge.me and paste into SourceMedium.

**1. Copy your API token from Judge.me**

In your Judge.me admin, go to **Settings → Integrations** and click **View API tokens**. Copy the **Private API Token**. See Judge.me's guide: [Using the Judge.me API](https://judge.me/help/en/articles/8409180-using-judge-me-api).

Judge.me's private token carries read and write access and has no read-only option, so treat it with extra care. SourceMedium only reads with it.

**2. Add the token in SourceMedium**

Find **Judge.me** in the connector picker and click **Connect**. Paste the API token and click **Connect**.

**3. Confirm it is connected**

SourceMedium checks the token with Judge.me before saving it, so a wrong token is rejected on the spot. The connection reads **Awaiting first data** until the first sync lands, then **Connected**.

> [!NOTE]
>
> SourceMedium only ever reads from your connected platforms. It does not create, change, or delete anything, so create the key with **read-only** access wherever the platform offers it. Treat it like a password: keep it confidential and avoid sharing it over email or in spreadsheets. If the credential is rotated or revoked, follow this guide's connection method to update SourceMedium.

## What data syncs

* **Reviews:** one row per review, updated as reviews change
* **Reviewers:** the reviewers behind those reviews
* **Shop info and settings:** your Judge.me shop record and its settings

Every row carries your store and its Shopify domain, so you can join reviews to your own order and product tables in warehouse models. Review replies are not included: Judge.me's API does not return them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.