Sources

Add and manage review sources. Connect to App Store, Google Play, Trustpilot, Google Reviews, Yelp, Facebook, G2, or import CSV files.

Create Source

POST/api/sources

Adds a new review source.

Body:

Example Request
{
  "projectId": "clx...",
  "type": "APP_STORE",
  "config": {
    "appId": "123456789",
    "country": "de"
  }
}

Supported Types:

  • APP_STORE - Apple App Store
  • GOOGLE_PLAY - Google Play Store
  • TRUSTPILOT - Trustpilot
  • GOOGLE_REVIEWS - Google Maps Reviews
  • FACEBOOK - Facebook Page Recommendations
  • G2 - G2 B2B Software Reviews
  • YELP - Yelp Business Reviews
  • CSV - CSV Import

Config Schemas:

APP_STORE:

{
  "appId": "string",
  "country": "string (ISO 3166-1 alpha-2, default: de)"
}

GOOGLE_PLAY:

{
  "packageName": "string (com.example.app)",
  "language": "string (default: de)"
}

TRUSTPILOT:

{
  "businessUnitId": "string (domain e.g. 'example.com' or Business Unit ID)",
  "apiKey": "string (required - your Trustpilot API Key / Client ID)"
}

Requires a Trustpilot Business account with API access. Get your API key at developers.trustpilot.com

GOOGLE_REVIEWS:

{
  "placeId": "string (Google Place ID)",
  "apiKey": "string (optional - your own Google Places API key)"
}

YELP:

{
  "businessId": "string (Yelp Business ID)",
  "apiKey": "string (optional - your Yelp Fusion API key)"
}

FACEBOOK:

{
  "pageId": "string (Facebook Page ID or Slug)",
  "accessToken": "string (optional, for official API access)"
}

G2:

{
  "productId": "string (G2 Product ID or Slug)",
  "apiKey": "string (optional, for official G2 API access)"
}

CSV:

{
  "data": "string (CSV content as JSON string)"
}

CSV files should contain columns: rating, text, author, date (or similar variations)

Response:

Response
{
  "source": {
    "id": "clx...",
    "projectId": "clx...",
    "type": "APP_STORE",
    "config": "{...}",
    "isActive": true,
    "lastSyncAt": null,
    "createdAt": "2026-02-07T19:39:27...",
    "updatedAt": "2026-02-07T19:39:27..."
  }
}

List Sources

GET/api/sources?projectId=xxx

Lists all sources for a project.