# Review Intelligence to Notion — Cross-Platform Review Feed API (`nexgendata/review-intelligence-notion`) Actor

- **URL**: https://apify.com/nexgendata/review-intelligence-notion.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 brand scorecards

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Review Intelligence to Notion

Aggregate reviews across platforms, score them and push a brand-level review digest straight into Notion.

> Public reviews only — reviewer identities are shown exactly as published on the source platform.

### ⏰ Run this as a weekly review monitor (recommended)

New results land continuously. Schedule a weekly sweep (`0 8 * * 1`) and catch fresh results as they post — always-on review monitoring.

### 📊 What you get

Clean JSON, one record per result (full output has 12 fields):

- `brand` — Brand
- `source` — Source
- `data_source` — Data source
- `review_count` — Review count
- `average_rating` — Average rating
- `rating_distribution` — Rating distribution
- `recent_average` — Recent average
- `top_complaint_themes` — Top complaint themes
- `top_praise_themes` — Top praise themes
- `recent_negative_reviews` — Recent negative reviews

**Pricing:** $0.100 per result (Pay-Per-Event) — about **10 results per $1**.

### 🤖 Use with AI agents

Point Claude, the OpenAI Agents SDK, an n8n flow or any MCP-aware client at it and pull data on demand.

**Agentic payments (x402):** Supports agentic payment via x402 — agents can call this actor with USDC, no API key required.

### 🔗 Related actors

**Review & app intelligence family — monitor reviews across every platform, score them, pipe them to Notion:**

[Apple App Store](https://apify.com/nexgendata/apple-app-store-scraper) · [Google Play Store](https://apify.com/nexgendata/google-play-store-scraper) · [Google Play Reviews](https://apify.com/nexgendata/google-play-reviews-scraper) · [iOS App Store Reviews](https://apify.com/nexgendata/ios-app-store-reviews-scraper) · [Google Maps Reviews](https://apify.com/nexgendata/google-maps-reviews) · [Amazon Reviews](https://apify.com/nexgendata/amazon-reviews) · [Capterra Reviews](https://apify.com/nexgendata/capterra-review-firehose) · [AI Sentiment Analyzer](https://apify.com/nexgendata/ai-sentiment-analyzer)

**Agent front door — Review Intelligence MCP:** [Review Intelligence MCP](https://apify.com/nexgendata/review-intelligence-mcp-server)

## *This actor is currently private — treated and ready for review.*

*Public web data, assembled for research and monitoring.*

# Actor input Schema

## `apps` (type: `array`):

What to score, one per line. The format depends on the chosen source:
• app\_store — App Store name, numeric App ID, or apps.apple.com URL (e.g. 'Notion', '1232780281', 'https://apps.apple.com/us/app/notion/id1232780281').
• google\_play — Play package id, Play Store URL, or app name (e.g. 'com.spotify.music', 'Notion').
• g2 — G2 product slug or product page URL (e.g. 'slack').
• trustpilot — company name or Trustpilot domain/URL (e.g. 'amazon.com', 'https://www.trustpilot.com/review/stripe.com'). Public review data only.

## `source` (type: `string`):

Which public review source to read from. app\_store (Apple App Store) and google\_play (Google Play) are the proven, ~93%+ reliable primary sources. g2 and trustpilot are also available but may be anti-bot blocked.

## `maxReviewsPerApp` (type: `integer`):

Maximum number of reviews to read per item before computing the scorecard (more reviews = more reliable themes and trend).

## `country` (type: `string`):

Storefront / region code for app\_store and google\_play (us, gb, ca, de, fr, jp, br, in, au, mx, etc.). For App Store, if the chosen storefront returns nothing the Actor automatically falls back to other storefronts. Ignored for g2/trustpilot.

## `language` (type: `string`):

Language code for google\_play reviews (e.g. en, es, de, fr). Ignored for other sources.

## `sortBy` (type: `string`):

Review ordering for app\_store / google\_play: newest first or most relevant/helpful first.

## `notionConnector` (type: `string`):

Connect your Notion workspace and this Actor writes the scorecards into a brand-new Notion database in the same run — it never sees your Notion credentials. Authorize a Notion MCP connector in Apify Console → Settings → API & Integrations, then select it here. (Without a connector you get the dataset only.)

## `notionParentId` (type: `string`):

Optional. The Notion page ID to create the scorecard database under. If blank, Notion creates it as a private page in your workspace.

## `supabaseConnector` (type: `string`):

Optional. Connect your own Supabase project and the results are also inserted into a table in the same run — the Actor never sees your Supabase credentials. Authorize a write-scoped, project-scoped Supabase MCP connector in Apify Console (Settings -> Integrations), then select it here.

## `supabaseTable` (type: `string`):

Target table in the public schema (created if missing, with id, a jsonb data column, and a scraped\_at timestamp). Default: nexgendata\_leads.

## `supabaseProjectId` (type: `string`):

Your Supabase project reference (e.g. abcdefghijklmnop). Required unless your connector URL is already project-scoped. Find it in your project URL: supabase.com/dashboard/project/THIS\_PART.

## `deliveryDedup` (type: `boolean`):

When on (default), records already delivered in a previous run are not delivered again to the same destination — so scheduled runs only push new items. Turn off to deliver every record on every run.

## Actor input object example

```json
{
  "apps": [
    "Notion",
    "Spotify"
  ],
  "source": "app_store",
  "maxReviewsPerApp": 100,
  "country": "us",
  "language": "en",
  "sortBy": "mostRecent",
  "supabaseTable": "nexgendata_leads",
  "deliveryDedup": true
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "apps": [
        "Notion"
    ],
    "source": "app_store",
    "maxReviewsPerApp": 100,
    "country": "us",
    "language": "en",
    "sortBy": "mostRecent"
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/review-intelligence-notion").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "apps": ["Notion"],
    "source": "app_store",
    "maxReviewsPerApp": 100,
    "country": "us",
    "language": "en",
    "sortBy": "mostRecent",
}

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/review-intelligence-notion").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "apps": [
    "Notion"
  ],
  "source": "app_store",
  "maxReviewsPerApp": 100,
  "country": "us",
  "language": "en",
  "sortBy": "mostRecent"
}' |
apify call nexgendata/review-intelligence-notion --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nexgendata/review-intelligence-notion",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/905gaVndWkmajyFzZ/builds/tSKHuGYesVLshMxB6/openapi.json