Advanced Analytica Advanced Analytica: IBOM
← All connectors
Yotpo logo

Source connector

Yotpo

Set up Yotpo as a source and move its data into your chosen destination.

Version 0.2.16 community alpha

Yotpo

Use this page to set up the Yotpo source connector and find reference information.

Prerequisites

To set up the Yotpo source connector, you’ll need:

  1. A Yotpo account with API access
  2. Your Yotpo App Key, found in your Yotpo account settings
  3. An Access Token generated from the Yotpo API

Setup guide

Step 1: Generate an Access Token

  1. Get your App Key and API Secret to generate an access token
  2. Find your App Key and API Secret in your Yotpo account settings
  3. Generate an access token using the Yotpo authentication endpoint:
    POST https://api.yotpo.com/oauth/token
    Include these parameters:
    {
      "client_id": "YOUR_APP_KEY",
      "client_secret": "YOUR_API_SECRET",
      "grant_type": "client_credentials"
    }
  4. Store the returned access token securely. You’ll use it for all API calls.

Step 2: Set up the Yotpo connector in Airbyte

Airbyte Cloud

  1. Log into your Airbyte Cloud account
  2. Select Sources from the left navigation bar. Then select New Source in the top-right corner
  3. On the Set up the source page, name the Yotpo connector. Select Yotpo from the Source type dropdown
  4. Enter these required parameters:
    • access_token: The access token generated in Step 1
    • app_key: Your Yotpo App Key
    • start_date: Your data sync start date (format: YYYY-MM-DDT00:00:00.000Z)
    • email: Your registered Yotpo email address
  5. Select Set up source

Airbyte OSS

  1. Go to the Airbyte Open Source dashboard
  2. Name your source
  3. Enter the required parameters described above
  4. Select Set up source

Supported sync modes

The Yotpo source connector supports these sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental SyncYes
Replicate Incremental DeletesNo
SSL connectionYes
NamespacesNo

Supported streams

Stream NameDescriptionIncrementalNotes
email_analyticsRetrieves aggregated data for email metricsNoData is grouped by metrics and can be filtered by date range
raw_dataReturns detailed data about every email sent from YotpoNoIncludes email recipient, delivery status, open/click events
reviewsRetrieves product reviewsYesUses created_at as cursor field with a lookback window of 31 days
unsubscribersLists users who have unsubscribed from emailsNoLimited to 5000 responses per request, requires pagination for larger datasets
webhooksLists all webhooks created for the accountNoIncludes webhook URL and event type information
webhook_eventsLists available webhook event typesNoIncludes event names and descriptions

Performance considerations

Rate limits

  • The Reviews endpoint allows 5,000 requests per minute for each app key
  • For Reviews, query up to 100 reviews per request. The default is 10
  • Review data has a retrieval delay of 1 hour

Pagination

  • The Reviews stream handles pagination automatically using page and count parameters
  • If the Unsubscribers list exceeds 5000 email addresses, use the count and page parameters for pagination

API method example

GET https://api.yotpo.com/v1/apps/{app_key}/reviews?utoken={access_token}

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.2.162025-10-2168442Update dependencies
0.2.152025-10-1468011Update dependencies
0.2.142025-10-0767250Update dependencies
0.2.132025-09-3066843Update dependencies
0.2.122025-09-2466469Update dependencies
0.2.112025-09-0965710Update dependencies
0.2.102025-08-2465429Update dependencies
0.2.92025-08-1064819Update dependencies
0.2.82025-08-0264357Update dependencies
0.2.72025-07-2664066Update dependencies
0.2.62025-07-1963622Update dependencies
0.2.52025-07-1263210Update dependencies
0.2.42025-07-0562684Update dependencies
0.2.32025-06-2862250Update dependencies
0.2.22025-06-2161748Update dependencies
0.2.12025-06-1547597Update dependencies
0.2.02024-08-2644780Refactor connector to manifest-only format
0.1.142024-08-2444661Update dependencies
0.1.132024-08-1744254Update dependencies
0.1.122024-08-1243891Update dependencies
0.1.112024-08-1043658Update dependencies
0.1.102024-08-0343198Update dependencies
0.1.92024-07-2742610Update dependencies
0.1.82024-07-2042275Update dependencies
0.1.72024-07-1341815Update dependencies
0.1.62024-07-1041444Update dependencies
0.1.52024-07-0941250Update dependencies
0.1.42024-07-0640795Update dependencies
0.1.32024-06-2540488Update dependencies
0.1.22024-06-2139945Update dependencies
0.1.12024-05-2038390[autopull] base image + poetry + up_to_date
0.1.02023-04-14InitInitial commit
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.