[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [Kwai account posts](https://spiral.ai/integrations/notion/kwai-account-posts)

# How to Use Kwai account posts in Notion

Kwai account posts returns public posts with captions, video and cover links, author details, and engagement counts. Use it to review a brand's publishing or compare posts across a campaign, with up to 50 posts per call.

|  |  |
| --- | --- |
| Model | Kwai account posts |
| Available through | ScrapeCreators |
| Category | Social Media |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Kwai account posts in Notion

- Every morning, use Kwai account posts for KwaiBrasilOficial and summarize posts newly encountered since the previous check, including captions and video links.
- Every Monday, use Kwai account posts for KwaiBrasilOficial and compare views, likes, comments, and forwards with last week's collection for matching posts.
- Each day, use Kwai account posts for https://www.kwai.com/@KwaiBrasilOficial and flag returned posts whose comment count has risen by at least 100 since the previous check.
- Every Friday, use Kwai account posts for KwaiBrasilOficial and summarize captions mentioning futebol, with the matching posts' engagement counts.
- Every evening, use Kwai account posts for KwaiBrasilOficial and list the five returned posts with the largest increase in forwards since yesterday's collection.

## How to set up Kwai account posts in Notion

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Notion this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

```text
https://api.spiral.ai/mcp
```

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

4. **Run Kwai account posts in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Kwai account posts, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Kwai account posts**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/kwai-user-posts",
    "input": {
      "url": "https://www.kwai.com/@KwaiBrasilOficial"
    }
  }'
```

Then paste one of the prompts above: Notion finds Kwai account posts on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/notion

## Kwai account posts tools and prices

- [Kwai · User Posts](https://spiral.ai/tools/scrapecreators/scrapecreators/kwai-user-posts) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| url |  | — | Kwai profile URL. Use this or handle. |
| count |  | — | Number of posts to return, max 50 |
| cursor |  | — | Cursor from the previous response for the next page |
| handle |  | — | Kwai profile handle. Use this or url. |

## What can you do with Kwai account posts in Notion?

Produce a daily digest of a Kwai brand account's public posts and a weekly comparison of their engagement counts. Compare successive collections to identify newly encountered posts and changes in views, likes, comments, and forwards.

### Compare campaign posts

Collect a brand account's public posts, select campaign captions, and compare views, likes, comments, and forwards across the returned posts.

### Build a caption research brief

Group a public business account's captions by topic and compare the engagement counts for each topic. Include examples for an editor to review.

### Measure changes in post performance

Compare repeated collections of the same brand posts to calculate changes in views, likes, comments, and forwards between checks.

### Prepare a publishing calendar review

Use the creation timestamps of returned business posts to count publications by day and identify gaps within the collected period.

### Create a visual review queue

Pair returned captions with cover links and video links so a content team can review a brand's posts alongside their engagement counts.

### Find posts that attract discussion

Rank a public account's returned posts by comment count and comments per view to choose posts for closer editorial review.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All Notion guides](https://spiral.ai/integrations/notion)

## Kwai account posts in other agents

- [Amp](https://spiral.ai/integrations/amp/kwai-account-posts)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/kwai-account-posts)
- [Claude](https://spiral.ai/integrations/claude-desktop/kwai-account-posts)
- [Claude Code](https://spiral.ai/integrations/claude-code/kwai-account-posts)
- [Cline](https://spiral.ai/integrations/cline/kwai-account-posts)
- [Codex](https://spiral.ai/integrations/codex/kwai-account-posts)
- [Cursor](https://spiral.ai/integrations/cursor/kwai-account-posts)
- [Devin](https://spiral.ai/integrations/devin/kwai-account-posts)
- [dots](https://spiral.ai/integrations/dots/kwai-account-posts)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/kwai-account-posts)
- [Gemini](https://spiral.ai/integrations/gemini/kwai-account-posts)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/kwai-account-posts)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/kwai-account-posts)
- [goose](https://spiral.ai/integrations/goose/kwai-account-posts)
- [Grok](https://spiral.ai/integrations/grok/kwai-account-posts)
- [Grok Build](https://spiral.ai/integrations/grok-build/kwai-account-posts)
- [Hermes](https://spiral.ai/integrations/hermes/kwai-account-posts)
- [Instinct](https://spiral.ai/integrations/instinct/kwai-account-posts)
- [Manus](https://spiral.ai/integrations/manus/kwai-account-posts)
- [Muse](https://spiral.ai/integrations/muse/kwai-account-posts)
- [Muse Code](https://spiral.ai/integrations/muse-code/kwai-account-posts)
- [n8n](https://spiral.ai/integrations/n8n/kwai-account-posts)
- [OpenClaw](https://spiral.ai/integrations/openclaw/kwai-account-posts)
- [opencode](https://spiral.ai/integrations/opencode/kwai-account-posts)
- [Perplexity](https://spiral.ai/integrations/perplexity/kwai-account-posts)
- [Raycast](https://spiral.ai/integrations/raycast/kwai-account-posts)
- [VS Code](https://spiral.ai/integrations/vscode/kwai-account-posts)
- [Windsurf](https://spiral.ai/integrations/windsurf/kwai-account-posts)
- [Zapier](https://spiral.ai/integrations/zapier/kwai-account-posts)

## More Notion guides

- [Komi creator page](https://spiral.ai/integrations/notion/komi-creator-page)
- [Kwai creator profile](https://spiral.ai/integrations/notion/kwai-creator-profile)
- [Kick clip transcript](https://spiral.ai/integrations/notion/kick-clip-transcript)
- [Kwai post details](https://spiral.ai/integrations/notion/kwai-post-details)
- [Kick clip details](https://spiral.ai/integrations/notion/kick-clip-details)
- [Lemon8 Discover banners](https://spiral.ai/integrations/notion/lemon8-discover-banners)

## Questions about Kwai account posts in Notion

**Can Notion use Kwai account posts?**

Yes. Add Spiral to Notion as an MCP server, and Notion can find and run Kwai account posts like any built-in tool.

**How much does Kwai account posts cost in Notion?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Notion plan is separate.

**Do I need a ScrapeCreators account to use Kwai account posts in Notion?**

No. Spiral runs Kwai account posts on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Kwai account posts in Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while Kwai account posts runs?**

Kwai account posts runs in the background. Notion starts the run, checks on it and gives you the json when it's ready.

**Does this include private Kwai posts?**

The documented coverage is public posts from a specified Kwai account. Private posts are outside that coverage.

**How many Kwai posts can one call return?**

The maximum is 50 posts per call. A request for 50 posts does not establish that the account's entire history has been retrieved.

**How do I retrieve another page of posts?**

Use the continuation cursor from the previous response. The account posts response supplies a next cursor when more results are available.

**Which engagement numbers are available?**

The documented Kwai post records include four counters: views, likes, comments, and forwards. These support separate rankings for viewing, reactions, discussion, and sharing.

**Does the response include video links or just captions?**

The account posts response includes media URLs and cover links alongside captions and author information.

