# Weibo Scraper 微博 (No Cookie)—Search, Posts, Comments & BlackCat (`axon-studio/weibo-scraper`) Actor

\[100% No Cookie / No Login — $4.5/1k] All-in-one Sina Weibo (新浪微博) & BlackCat (黑猫投诉) API. Extract keyword search, creator timelines (user_posts with NO cookie!), hot search (微博热搜), comments with English provinces, KOL profiles & sentiment. Auto EN->ZH translation.

- **URL**: https://apify.com/axon-studio/weibo-scraper.md
- **Developed by:** [Axon Studio](https://apify.com/axon-studio) (community)
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.80 / 1,000 item scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Weibo Scraper — Chinese Social Intelligence & BlackCat API (100% No Cookie / No Login)

Extract Chinese public opinion, real-time trending topics, creator timelines, comment threads, and consumer complaints from **Sina Weibo (新浪微博)** and **BlackCat (新浪黑猫投诉)** — China's dominant microblogging and public-opinion platform with **580M+ monthly active users**.

Built for **AI/LLM training corpora, Chinese consumer equity research (alt-data), global brand monitoring agencies, KOL due diligence, and automated RAG workflows** (n8n, Make, Dify, LangGraph, Claude MCP). **No API key, no VPN, and no Weibo login or cookies required.** Users on the **Apify Free plan can extract up to 1,111 Weibo items per month for free**.

***

### Why Choose This Weibo Scraper (Features)

| Weibo Scraper Capability | Built-In Advantage |
| :--- | :--- |
| **Managed Cloud Session Pool (No Cookie Needed)** | Runs all 9 modes—including **`user_posts` (creator timelines)** and **BlackCat keyword search**—completely cookie-free via our built-in managed session pool and PC/Mobile dual-engine fallback. |
| **Deep Weibo Search (>1,000 Posts/Run)** | Bypasses Weibo's 30-post anonymous page limit using **5 content streams** + **80+ unbiased Chinese grammatical particles** (`的`, `了`, `在`, `是`...) without distorting sentiment polarity. |
| **Auto EN ↔ ZH Brand Localization** | Searching an English brand on Weibo (e.g., `Tesla`, `Nike`, `Luckin`) automatically translates and searches both the Chinese (`特斯拉`, `耐克`, `瑞幸咖啡`) and English terms simultaneously. |
| **Author Followers Included Free** | Every Weibo `search` and `user_posts` row includes `authorFollowers`, `authorVerified`, and `authorVerifiedReason` at no extra cost. |
| **Full Text Expansion (`>140` chars)** | Automatically expands truncated Weibo long posts (`...全文`) via dual PC & Mobile extend endpoints. |
| **Chinese & English Sentiment Analysis** | Zero-RAM sentiment lexicon with **Chinese negation reversal** (`"不满意"` → negative, `"不错"` → positive) and degree weighting. |
| **Weibo IP Province Geolocation (`regionEn`)** | Automatically maps Chinese IP location labels (`发布于 广东`) into standardized English names (`Guangdong`, `Shanghai`, `Beijing`). |
| **256 MB RAM Real-Time Streaming** | Streams records to your Dataset in real-time batches of 10 rows on just **256 MB RAM**—preserving every scraped batch if a run stops early. |

***

### How to Scrape Weibo in 3 Easy Steps

1. **Select a Weibo `mode`** — Choose from 9 modes (`search`, `realtime_search`, `user_posts`, `hot_timeline`, `hot_search`, `user_profile`, `post_details`, `post_comments`, or `complaints`).
2. **Enter your target** — Type a brand or topic in **English or Chinese** (e.g., `Tesla`, `Luckin`, `Apple`, `瑞幸咖啡`, `人工智能`) or paste Weibo User UIDs / Post URLs.
3. **Click "Start"** — Download your Weibo data in **JSON, CSV, Excel, or Parquet**, or connect via API, Webhooks, n8n, Make, or Claude MCP.

***

### Weibo Scraper Use Cases

| Buyer Profile | Weibo & BlackCat Use Case |
| :--- | :--- |
| **AI / LLM Training Data Teams** | Real-time Simplified Chinese Weibo microblog text and comment threads for SFT, RLHF, and current-events RAG grounding |
| **Hedge Funds & Equity Research** | Track Weibo brand mention velocity, BlackCat complaint spikes, and hot-search momentum on Chinese consumer stocks (BYD, POP MART, Anta, Luckin, Yum China, NIO, Xiaomi) |
| **Brand Monitoring & PR Agencies** | Real-time tracking of Western brand mentions on Weibo, campaign reception, and crisis detection |
| **KOL & Influencer Marketing** | Evaluate Weibo KOLs by follower count, verification badge (`黄V` / `蓝V`), timeline engagement, and audience province distribution |
| **Academic NLP & Policy Analysts** | Chinese microblog corpus with labeled sentiment and regional conversation distribution (`regionEn`) |

***

### Weibo Scraper Input & 9 Modes Configuration

All parameters are documented in the **Input** tab. Below is the summary of all 9 Weibo and BlackCat modes:

| Mode | What It Extracts from Weibo / BlackCat | Input Needed | Cookies Needed? |
| :--- | :--- | :--- | :--- |
| **`search`** | Deep Weibo keyword search across 5 streams (comprehensive, realtime, hot, video, image) | `searchQuery` | **No** |
| **`realtime_search`** | Strictly chronological latest Weibo posts matching your keyword | `searchQuery` | **No** |
| **`user_posts`** | Full historical Weibo post timeline of specific creators, brands, or KOLs | `userIds` | **No (Built-in Pool)** |
| **`hot_timeline`** | Viral high-engagement posts currently pushed on Weibo's discovery feeds | *None (Click Start)* | **No** |
| **`hot_search`** | Real-time Top 50 Weibo Trending Board (`微博热搜榜`) with heat scores & badges (`新`/`热`/`沸`/`爆`) | *None (Click Start)* | **No** |
| **`user_profile`** | Weibo creator metrics: followers, following, total posts, verification, bio, location | `userIds` | **No** |
| **`post_details`** | Single Weibo post tracker: latest likes, reposts, comments, and full text | `postIds` | **No** |
| **`post_comments`** | Weibo comment thread extraction with commenter IP province mapping (`regionEn`) | `postIds` or `searchQuery` | **No** |
| **`complaints`** | **BlackCat (`新浪黑猫投诉`)** consumer disputes: company, title, appeal (`退款/赔偿`), status | `searchQuery` *(optional)* | **No** |

#### Cascade Add-ons: Scrape Replies & Author Profiles in One Run

When running `search`, `realtime_search`, `user_posts`, `hot_timeline`, or `post_details`, enable these optional toggles:

- **`scrapeComments: true`**: Automatically extracts up to `maxCommentsPerPost` comments under each Weibo post (posts with 0 comments are skipped automatically; each comment is billed as 1 row). Pairing `hot_timeline` (`maxResults: 10`) with `scrapeComments: true` (`maxCommentsPerPost: 20`) yields ~190 rows in one pass.
- **`includeAuthorProfiles: true`**: Emits a dedicated `user_profile` row (`authorDescription`, `authorFollowing`, `statusesCount`, `location`) for each unique Weibo post author at zero extra network latency (billed as 1 row per unique author).

#### JSON Input Examples

##### 1. Weibo Keyword & Brand Search with Date Window (`search`)

```json
{
  "mode": "search",
  "searchQuery": "Tesla",
  "autoLocalize": true,
  "searchAliases": ["Model Y", "Cybertruck"],
  "dateStart": "2026-09-01",
  "dateEnd": "2026-10-24",
  "maxResults": 200,
  "fullText": true,
  "sentimentAnalysis": true,
  "adFilter": true
}
```

##### 2. Weibo Creator Timeline Posts — No Cookie Required (`user_posts`)

```json
{
  "mode": "user_posts",
  "userIds": ["1749127163", "https://weibo.com/u/1642634100"],
  "maxResults": 100,
  "fullText": true,
  "sentimentAnalysis": true
}
```

##### 3. Weibo Comments & Province Rollup (`post_comments`) & BlackCat (`complaints`)

```json
{
  "mode": "post_comments",
  "postIds": ["5356654347420790"],
  "maxResults": 200,
  "sentimentAnalysis": true
}
```

***

### Automated Daily Weibo Monitoring (Schedules & Delta Mode)

Turn this Weibo Scraper into a **24/7 automated Chinese brand and public-opinion feed** in 2 minutes:

1. Run the Actor once with your target `searchQuery`, `user_posts`, or `complaints` input.
2. In **Apify Console → Schedules → Create new schedule**, select **`axon-studio/weibo-scraper`** and set your cron schedule (e.g., hourly `0 * * * *` or daily `0 8 * * *`).
3. Enable **`deltaMode: true`** in the input. The Actor stores up to 10,000 scraped IDs in your Key-Value Store (`DELTA_SEEN_IDS`) and automatically skips previously delivered items on future runs—so you only pay for brand-new Weibo mentions.

```json
{
  "mode": "search",
  "searchQuery": "Nike",
  "autoLocalize": true,
  "deltaMode": true,
  "maxResults": 100,
  "sentimentAnalysis": true
}
```

***

### Scrape Weibo with Python, JavaScript, REST API & MCP

#### 1. Python (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")
run = client.actor("axon-studio/weibo-scraper").call(run_input={
    "mode": "search",
    "searchQuery": "Luckin",
    "autoLocalize": True,
    "maxResults": 100,
    "fullText": True,
    "sentimentAnalysis": True,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("postId"), item.get("authorName"), item.get("sentiment"), item.get("text", "")[:60])
```

#### 2. JavaScript / TypeScript (`apify-client`)

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

const client = new ApifyClient({ token: 'YOUR_APIFY_API_TOKEN' });
const run = await client.actor('axon-studio/weibo-scraper').call({
    mode: 'search',
    searchQuery: 'Tesla',
    maxResults: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} Weibo records:`, items[0]);
```

#### 3. Synchronous REST API (cURL / n8n / Make / Dify / Claude MCP)

- **n8n / Make / Zapier**: Use the official Apify integration to run `axon-studio/weibo-scraper` and pipe results into OpenAI, Claude, DeepSeek, or Google Sheets.
- **Claude Desktop / Cursor (MCP)**: Click **"Copy setup prompt"** at the top right of this page to use this Weibo Scraper inside your AI agent.

```bash
curl -X POST "https://api.apify.com/v2/acts/axon-studio~weibo-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","searchQuery":"Tesla","maxResults":50,"sentimentAnalysis":true}'
```

***

### Weibo Scraper Output Examples

#### 1. Weibo Post Row (`search`, `realtime_search`, `user_posts`, `hot_timeline`, `post_details`)

```json
{
  "postId": "5356654347420790",
  "mblogid": "RnLPYv8ua",
  "mode": "search",
  "searchQuery": "特斯拉",
  "text": "今天深度试驾了特斯拉焕新版 Model Y，智能辅助驾驶体验非常丝滑，能耗控制也很满意！",
  "sentiment": "positive",
  "sentimentScore": 0.8,
  "createdAt": "Thu Oct 22 03:03:01 +0800 2026",
  "createdAtIso": "2026-10-22T03:03:01+08:00",
  "authorId": "7758432697",
  "authorName": "科技观察员",
  "authorAvatar": "https://tvax1.sinaimg.cn/crop.0.0.1080.1080.180/...",
  "authorVerified": true,
  "authorVerifiedReason": "科技领域优质创作者",
  "authorFollowers": "8.9万",
  "attitudesCount": 128,
  "commentsCount": 34,
  "repostsCount": 12,
  "regionName": "广东",
  "regionEn": "Guangdong",
  "images": ["https://wx1.sinaimg.cn/large/008s..."],
  "isPromoted": false,
  "isRepost": false,
  "postUrl": "https://weibo.com/7758432697/RnLPYv8ua",
  "scrapedAt": "2026-10-22 03:20:34 UTC"
}
```

#### 2. Weibo Comment Row (`post_comments`) & Creator Profile Row (`user_profile`)

```json
{
  "mode": "post_comments",
  "postId": "5356654347420790",
  "commentId": "5356658192014412",
  "text": "确实很稳，周末也准备去门店试驾一下！",
  "sentiment": "positive",
  "sentimentScore": 0.67,
  "createdAtIso": "2026-10-22T03:15:10+08:00",
  "authorId": "6108685154",
  "authorName": "数码玩家Leo",
  "authorVerified": false,
  "regionName": "上海",
  "regionEn": "Shanghai",
  "likesCount": 19,
  "scrapedAt": "2026-10-22 03:20:36 UTC"
}
```

#### 3. BlackCat Consumer Complaint Row (`complaints` / 黑猫投诉)

```json
{
  "mode": "complaints",
  "sn": "17402361718",
  "company": "某咖啡品牌",
  "title": "小程序优惠券无法核销且客服拒绝退差价",
  "appeal": "退款,改善服务",
  "text": "本人于今日在门店下单时小程序卡顿导致优惠券未生效，联系客服处理敷衍...",
  "summary": "本人于今日在门店下单时小程序卡顿导致优惠券未生效，联系客服处理敷衍...",
  "sentiment": "negative",
  "sentimentScore": -0.78,
  "statusEn": "in_progress",
  "scrapedAt": "2026-10-22 03:20:40 UTC"
}
```

***

### Weibo Scraper Pricing & Free Plan Credits

**$4.50 per 1,000 results (`$0.0045` per item) + `$0.02` per Actor start (Pay-Per-Event)**

- **Free Plan Credits**: Every Apify account includes **$5.00 in free monthly credits**, covering up to **1,111 Weibo posts, comments, profiles, or BlackCat complaints every month for free**.
- **Volume Discounts**: Automatic lower unit prices for Apify **Bronze / Starter**, **Silver / Scale**, and **Gold / Business** plan subscribers.
- **No Extra Server Compute Fees**: Memory and CPU usage are included in the Pay-Per-Event rate.
- **Typical Run Costs**: 50 Weibo Hot Search topics = **`$0.245`** · 100 Brand Search posts = **`$0.47`** · 100 Creator Timeline posts (`user_posts`) = **`$0.47`** · 10,000 Weibo posts for AI training = **`$45.02`**.

***

### Weibo Scraper FAQ

#### Is there an official Weibo API for international developers?

Sina Weibo's commercial API requires a Chinese business license (`营业执照`), enterprise review, and high annual fees. This Weibo Scraper provides a plug-and-play alternative requiring no Chinese entity, no VPN, and no Weibo account.

#### Do I need to provide Weibo cookies for `user_posts` or search?

**No.** All 9 modes—including `user_posts` (creator timelines), `search`, `post_comments`, and `complaints`—use our built-in managed session pool and anonymous visitor rotation automatically.

#### Legal & GDPR / PIPL Compliance

This Actor extracts publicly available information from Sina Weibo and BlackCat public endpoints and does not access private or locked accounts. Public creator names, UIDs, bios, and IP province labels may constitute personal data under **GDPR** or **PIPL**; ensure you have a lawful basis for processing public social data. *Not affiliated with Sina Corporation or Weibo.*

# Actor input Schema

## `mode` (type: `string`):

Choose what data to extract. All 9 modes work out-of-the-box with NO login or cookies required.

## `searchQuery` (type: `string`):

Enter any brand, product, or topic in English or Chinese (e.g., Tesla, Luckin, Apple, 瑞幸咖啡). Ignored in Hot Timeline / Hot Search modes.

## `autoLocalize` (type: `boolean`):

Automatically translates English keywords or brand names into Chinese to maximize Weibo search coverage.

## `searchAliases` (type: `array`):

Extra keywords or brand aliases to merge in the same search run.

## `dateStart` (type: `string`):

Only keep posts published on or after this date (e.g., 2026-01-01). Leave empty for no limit.

## `dateEnd` (type: `string`):

Only keep posts published on or before this date (e.g., 2026-12-31). Leave empty for no limit.

## `userIds` (type: `array`):

Weibo numeric UIDs (e.g. 1749127163) or profile URLs (https://weibo.com/u/1749127163).

## `postIds` (type: `array`):

Weibo 16-digit post IDs (e.g. 5353919800151224), mblogids (RnAwdBkNU), or full post URLs.

## `maxResults` (type: `integer`):

Maximum number of primary items (posts, profiles, or complaints) to scrape (1 to 5,000).

## `fullText` (type: `boolean`):

Automatically fetches the complete untruncated text when a Weibo post exceeds 140 characters.

## `sentimentAnalysis` (type: `boolean`):

Automatically tags every post, comment, and complaint with sentiment polarity and a normalized score (-1.0 to +1.0).

## `scrapeComments` (type: `boolean`):

Automatically extracts top comments under each scraped post (no cookie needed). Each comment is output and billed as 1 item.

## `maxCommentsPerPost` (type: `integer`):

Maximum number of comments to extract per post when comment scraping is enabled.

## `includeAuthorProfiles` (type: `boolean`):

Outputs a dedicated user_profile row for each unique post author (followers, bio, verification). Charged per row.

## `adFilter` (type: `boolean`):

Skip sponsored promotions in search results.

## `deltaMode` (type: `boolean`):

Remembers scraped IDs across runs and only outputs newly published items.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "Tesla",
  "autoLocalize": true,
  "searchAliases": [],
  "dateStart": "",
  "dateEnd": "",
  "userIds": [
    "1749127163"
  ],
  "postIds": [
    "5353919800151224"
  ],
  "maxResults": 50,
  "fullText": true,
  "sentimentAnalysis": true,
  "scrapeComments": false,
  "maxCommentsPerPost": 10,
  "includeAuthorProfiles": false,
  "adFilter": false,
  "deltaMode": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("axon-studio/weibo-scraper").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("axon-studio/weibo-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call axon-studio/weibo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axon-studio/weibo-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/4vo0TNcDK5DfV31xy/builds/SngtIIN2i9cJ54twH/openapi.json