# Weibo Scraper (`sian.agency/weibo-scraper`) Actor

Weibo scraper — extract Weibo posts, user profiles, fans, followers, and keyword search results from Sina Weibo. KOL discovery, social graph mapping, sentiment data, and China market research. Five operations, one clean dataset per run. No API key needed.

- **URL**: https://apify.com/sian.agency/weibo-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Social media, Marketing, Automation
- **Stats:** 3,856 total users, 2,331 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: No ratings yet

## Pricing

from $18.75 / 1,000 weibo details

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 — Posts, Profiles, Fans, Followers & Search 📱

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Taobao & Tmall](https://img.shields.io/badge/Store-Taobao%20%26%20Tmall-FF4F00)](https://apify.com/sian.agency/taobao-tmall-product-scraper?fpr=sian) [![Kwai & Kuaishou](https://img.shields.io/badge/Store-Kwai%20%26%20Kuaishou-FF4906)](https://apify.com/sian.agency/kwai-kuaishou-scraper?fpr=sian) [![Instagram Transcripts](https://img.shields.io/badge/Store-Instagram%20Transcripts-E4405F)](https://apify.com/sian.agency/instagram-ai-transcript-extractor?fpr=sian)

#### 🎉 Five scrapers in one — extract Weibo posts, user profiles, fans, followers, and date-ranged keyword search from Sina Weibo

##### Built for China-market researchers, KOL agencies, brand monitoring teams, and journalists who need clean structured Weibo data — no Weibo developer account, no API key, no setup headaches

***

### 🔍 What is the Weibo Scraper — and when should you use it?

The **Weibo Scraper** turns a Weibo post ID, a user ID or a plain search keyword into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No Weibo developer account, no portal API key, no browser automation to maintain.

**Use it when you need:** Weibo post text with repost, comment and like counts, topics and @-mentions. Full user profiles carry follower, following and post totals. You can also pull the fan and follower list behind any public account, or search keywords across a date window you pick.

**Use something else when:** the conversation you care about is happening on another Chinese platform. Use [Xiaohongshu KOL Analytics](https://apify.com/sian.agency/xiaohongshu-kol-analytics?fpr=sian) for creator scoring on RED, or [Kwai & Kuaishou Scraper](https://apify.com/sian.agency/kwai-kuaishou-scraper?fpr=sian) for short-video posts and profiles.

***

### 🤖 Use with AI agents

Already connected to the [Apify MCP server](https://mcp.apify.com)? Just ask for this Actor by name: sian.agency/weibo-scraper

**Your agent can pay for its own runs.** This Actor is eligible for [agentic payments](https://docs.apify.com/platform/actors/publishing/monetize), so an agent can discover it, run it and settle the bill over [x402](https://www.x402.org/) (USDC on Base) or [Skyfire](https://www.skyfire.xyz/) — without an Apify account or API token of its own. Billing is the same either way: per successful row, never for errors.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
I want to track what Chinese Weibo users are saying about a brand using the Apify Actor `sian.agency/weibo-scraper`.

Use it when I need: Weibo posts with engagement counts, Weibo user profiles, fan and follower lists, or keyword search over a date range.

Don't use it when: the platform is Xiaohongshu or Kuaishou — use `xiaohongshu-kol-analytics` or `kwai-kuaishou-scraper` instead.

How to call it: pick ONE `operation` per run.
  searchWeibo   — needs `keyword`, optional `startDay` / `endDay` (YYYY-MM-DD) and `maxPages`
  weiboDetail   — needs `weiboId` (the 16-digit post ID)
  userDetail    — needs `userId` (the numeric UID)
  userFans      — needs `userId`, optional `maxPages`
  userFollowers — needs `userId`, optional `maxPages`

Start with this input:
{
  "operation": "searchWeibo",
  "keyword": "北京",
  "startDay": "2026-07-01",
  "endDay": "2026-07-31",
  "maxPages": 3
}

Ask me for the keyword or the account I care about, then run the Actor and summarise the results as a table sorted by repost count.
```

**Things you can ask your agent for:**

- *"Find the 20 most reposted Weibo posts mentioning our brand last month and tell me the sentiment split."*
- *"Pull the profile and follower list for this Weibo account, then tell me which of its followers are verified."*
- *"Search Weibo for 新能源汽车 across July and August and chart how the conversation volume moved."*

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at [apify.com/sian.agency/weibo-scraper.md](https://apify.com/sian.agency/weibo-scraper.md).

***

### 📋 Overview

**Tired of brittle DIY Weibo scrapers that break every time Sina ships an interface tweak?** This actor delivers reliable, flat structured datasets from China's biggest microblog (550M+ MAU) — one clean run per task, one tidy dataset out.

**What you get:**

- ✅ **Five operations, one actor**: Weibo detail · user profile · user fans · user followers · keyword search
- 🌐 **The only Weibo actor on Apify with full social graph extraction** — competitors stop at posts and profiles; we expose fan and follower lists
- 📅 **Date-range search** — track how a topic surged or faded across weeks (rivals search current only)
- 🎯 **Production-ready data shape**: curated camelCase aliases (`weiboId`, `userId`, `screenName`, `repostCount`, `attitudeCount`, `text`, `postedAt`…) PLUS every raw Weibo field for power users
- 💰 **Pay-per-result pricing** — only charged for successful extractions, never for empty pages or errors
- 💎 **No Weibo account, no API key, no proxies** — paste a post ID, UID, or keyword and run
- ✨ **NEW**: 16-digit Weibo post IDs preserved at full precision (most scrapers silently corrupt them); HTTPS auto-normalized on every avatar, cover, and picture URL

***

### ✨ Features

- 📝 **Weibo Detail**: full post by ID with 50+ fields — text, location, topics, @-mentions, repost/comment/attitude (like) counts, attached pictures, creator info, posting client, region
- 👤 **User Profile**: full profile by UID — followers, following, statuses count, verification reason, location, gender, bio, membership tier, avatar set, cover image
- 👥 **User Fans**: list of accounts that follow a target user (~20 per page, respects Weibo privacy settings)
- ➡️ **User Followers**: list of accounts a target user follows (~20 per page, respects Weibo privacy settings)
- 🔍 **Search Weibo**: keyword search with optional start/end date (defaults to last 30 days), ~14 posts/page, Chinese/English/mixed queries supported
- 🖼️ **HTTPS-normalized URLs**: every avatar, cover, picture, embedded video URL ready to embed
- 🆔 **BigInt-safe IDs**: 16-digit Weibo post IDs preserved (no precision loss → no broken cross-operation joins)
- 🔁 **Auto-retry transient failures**: HTTP 502/503/504 and transient rate-limit responses retried with exponential backoff
- 📄 **Pagination cap**: stream through up to 50 pages per run with one input parameter
- 📊 **HTML run report**: saved automatically to the key-value store — a preview of your first rows, an itemized charges statement, the failed items with a fix for each, and a copy-ready API call

***

### 🎬 Quick Start

Paste a Weibo keyword to find trending Chinese conversations — no Weibo developer account or Sina API required.

```bash
curl -X POST https://api.apify.com/v2/acts/sian.agency~weibo-scraper/runs?token=YOUR_TOKEN \
-d '{"operation":"searchWeibo","keyword":"北京","maxPages":3}'
```

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Pick an operation

Choose what you want to extract: Search Weibo, Weibo Detail, User Profile, User Fans, or User Followers.

#### Step 2: Enter the input

A keyword (search), a Weibo post ID (detail), or a user UID (profile / fans / followers).

#### Step 3: Click "Start"

Results stream into the Apify dataset as they come back. Download as JSON, CSV, or Excel directly from the Console.

**That's it! In under 60 seconds, you'll have:**

- A flat, structured dataset (no nested Weibo card JSON to parse)
- Curated camelCase fields plus the raw response for power users
- An HTML report summarizing the run
- Ready-to-embed HTTPS media URLs (avatars, pictures, covers)

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `operation` | string (enum) | Yes | One of: `weiboDetail` · `userDetail` · `userFans` · `userFollowers` · `searchWeibo` |
| `weiboId` | string | If operation is `weiboDetail` | Numeric Weibo post ID (also called `mid`). Find it in any `https://m.weibo.cn/detail/{ID}` URL or in any search result's `weiboId` field. |
| `userId` | string | If operation is `userDetail`, `userFans`, or `userFollowers` | Numeric Weibo user ID (UID). Find it in any `https://weibo.com/u/{ID}` URL or in any result row's `userId` field. |
| `keyword` | string | If operation is `searchWeibo` | Search query (Chinese, English, or mixed — e.g. `北京`, `Tesla`, `美食`) |
| `startDay` | string | No (search only) | Earliest date `YYYY-MM-DD`. Defaults to 30 days ago. |
| `endDay` | string | No (search only) | Latest date `YYYY-MM-DD`. Defaults to today. |
| `maxPages` | integer | No | Pages to fetch for paginated operations (default 5, max 50) |

**Example — Search trending Weibo posts:**

```json
{
  "operation": "searchWeibo",
  "keyword": "iPhone",
  "startDay": "2026-04-12",
  "endDay": "2026-05-12",
  "maxPages": 3
}
```

**Example — Map a creator's fan network:**

```json
{
  "operation": "userFans",
  "userId": "2760523085",
  "maxPages": 5
}
```

**Example — Get full Weibo post details by ID:**

```json
{
  "operation": "weiboDetail",
  "weiboId": "5249718969175092"
}
```

***

### 📤 Output

Results are saved to the Apify dataset with **40+ curated fields** plus every raw Weibo field. Filter by `_operation` to split modes; a curated Overview view opens by default in Apify Console, with every raw field one click away via "All fields."

| Field | Type | Description |
|-------|------|-------------|
| `weiboId` | string | Weibo post ID (16-digit, precision preserved) |
| `bid` | string | Base-62 short post ID |
| `weiboPageUrl` | string | Direct link to the mobile Weibo post page |
| `text` | string | Post body (Chinese / English / mixed) |
| `textLength` | integer | Character count of post text |
| `isLongText` | boolean | True if long-form (>140 char) post |
| `postedAt` | string | Upload timestamp (RFC-2822 style) |
| `repostCount` | integer | Reposts (转发) |
| `commentCount` | integer | Comments (评论) |
| `attitudeCount` | integer | Likes (点赞) |
| `regionName` | string | Region the post was made from |
| `source` | string | Client app used to post |
| `topics` | array | Hashtag / topic entities |
| `atUsers` | array | @-mention entities |
| `picCount` | integer | Number of attached pictures |
| `picUrls` | array | All attached picture URLs |
| `videoUrl` | string | Embedded video URL (if any) |
| `userId` | string | Creator's Weibo UID |
| `screenName` | string | Creator's display name |
| `verified` | boolean | Verified badge |
| `verifiedReason` | string | Verification description |
| `followersCount` | integer | Followers / fans (profile rows) |
| `friendsCount` | integer | Following count (profile rows) |
| `statusesCount` | integer | Total post count (profile rows) |
| `gender` | string | Self-reported gender (profile rows) |
| `location` | string | Self-reported location (profile rows) |
| `description` | string | Profile bio (profile rows) |
| `avatarUrl` | string | Profile picture HD (HTTPS) |
| `userPageUrl` | string | Direct link to Weibo profile page |

**Example dataset row (search Weibo):**

```json
{
  "_operation": "searchWeibo",
  "_sourceKeyword": "Tesla",
  "weiboId": "5297759758582315",
  "bid": "QkRpSCuRm",
  "userId": "2008330545",
  "screenName": "KeepItMelloMachine_",
  "text": "New Tesla Supercharger: Taoyuan, Yangmei, Taiwan - Sanyuan St…",
  "repostCount": 0,
  "commentCount": 0,
  "attitudeCount": 0,
  "postedAt": "2026-05-12 11:17:33",
  "weiboPageUrl": "https://m.weibo.cn/detail/5297759758582315",
  "userPageUrl": "https://weibo.com/u/2008330545",
  "status": "success"
}
```

***

### 💼 Use Cases & Examples

#### 1. KOL & Influencer Discovery for Chinese Brands

**Influencer marketing teams** at brands launching in China shortlisting Weibo KOLs.

**Input:** Search Weibo with keyword "美妆" (beauty) or "数码" (digital), then User Profile on top creators
**Output:** 14 posts per page, plus full profile data on follow-up
**Use:** Build a ranked KOL shortlist in 5 minutes, not 5 hours of scrolling.

#### 2. Social Graph Mapping (unique to this actor)

**Influencer-marketing agencies** mapping a creator's audience and adjacent network.

**Input:** User Fans + User Followers operations on a target UID
**Output:** Up to 1,000 fan rows and 1,000 follower rows, each with full profile data
**Use:** See who a creator's audience already follows, then measure overlap before you sign them.

#### 3. China Market-Entry Research

**Market intelligence analysts** monitoring Weibo conversation before launching a brand in China.

**Input:** Search Weibo with industry keyword + date range across 10 pages
**Output:** 140 posts with engagement metrics, locations, topics, posting clients
**Use:** Size the conversation and see which regions carry it, weeks before launch.

#### 4. Brand Monitoring on Weibo

**Brand managers** tracking unauthorized mentions, branded-content performance, and counterfeits on China's biggest microblog.

**Input:** Scheduled Search Weibo with brand or product keyword
**Output:** Every new mention with creator + engagement
**Use:** React to viral mentions in near real-time; flag counterfeits & PR risks.

#### 5. Sentiment & Crisis Monitoring

**NLP / brand-perception teams** analyzing Weibo reactions during a campaign or crisis.

**Input:** Weibo Detail on viral post IDs, plus Search Weibo with crisis keywords
**Output:** Full post payloads with text, topics, regions, repost/comment/like counts
**Use:** Feed a Chinese-language sentiment model; track crisis evolution hour by hour.

#### 6. Trend & Topic Tracking

**Content strategists** at agencies tracking Weibo virality patterns weekly.

**Input:** Scheduled Search Weibo with niche keywords + date filter
**Output:** Time-series of conversation volume + engagement velocity
**Use:** Feed a trend dashboard; spot rising topics before they break.

#### 7. Journalism & China Research

**Journalists and academic researchers** tracking topic surges in Chinese public discourse.

**Input:** Date-windowed Search Weibo across campaign or news event
**Output:** Comprehensive corpus of public discussion with metadata
**Use:** Compare conversation volume across events; quantify Chinese public reaction with timestamps.

***

### 🔗 Integration Examples

#### JavaScript / Node.js

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/weibo-scraper').call({
  operation: 'searchWeibo',
  keyword: '北京',
  maxPages: 3,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/weibo-scraper').call(
    run_input={'operation': 'userFans', 'userId': '2760523085', 'maxPages': 5}
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~weibo-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation":"weiboDetail","weiboId":"5249718969175092"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. **Trigger**: schedule daily or webhook from a brief-creator
2. **HTTP Request**: call the actor's run-sync endpoint with `operation` + input
3. **Process**: filter by `_operation` and pivot on `weiboId` / `userId`
4. **Action**: push to BigQuery, Notion, Airtable, or a Slack alert

***

### 📊 Performance & Pricing

#### FREE Tier (Try It Now)

- **Full feature access** — every operation, every field, no quality compromise
- No credit card required
- Perfect for evaluating data depth before you commit

#### PAID Tier (Production Ready)

- **Unlimited** results per run
- Faster processing — no FREE-tier throttling
- Pay-per-result: only charged for successful rows, never for errors or empty pages
- Volume discounts up to 50% off at GOLD/PLATINUM/DIAMOND Apify tiers

💰 **Best price on the market for premium Weibo data** — see pricing tab for the full per-event ladder. Single-row operations (Weibo Detail, User Profile) carry richer payloads at premium pricing; bulk operations (Fans, Followers, Search) are priced to scale.

🔗 [View current pricing](https://apify.com/sian.agency/weibo-scraper?fpr=sian)

***

### ❓ Frequently Asked Questions

**Q: How many posts / users can I extract per run?**
A: FREE tier: full feature access for evaluation. PAID tier: unlimited — capped only by `maxPages` (default 5, max 50) and platform-side data availability.

**Q: Does it work with private profiles or shadow-banned accounts?**
A: No — only publicly accessible Weibo content is supported. Private accounts return empty rows; banned users return error rows with the translated message.

**Q: Why do some fan / follower lists return empty?**
A: A significant share of Weibo users restrict public access to their fan or follower list. The actor detects this and emits a single translated explanatory row instead of crashing. Try a different UID.

**Q: What output formats are available?**
A: JSON, CSV, Excel, RSS, HTML, XML — export directly from the Apify dataset UI or via API.

**Q: Why are Weibo post IDs 16 digits — does the dataset preserve them?**
A: Yes. We use a bigint-safe JSON parser so 16-digit IDs round-trip without precision loss. Most scrapers silently corrupt these via JavaScript's `Number.MAX_SAFE_INTEGER` overflow and break cross-operation joins.

**Q: Can I search in Chinese?**
A: Absolutely. Chinese, English, and mixed queries all work — Chinese surfaces more native conversations; English/brand queries surface international mentions.

**Q: How does the date filter work for search?**
A: Pass `startDay` / `endDay` in `YYYY-MM-DD` format. The actor defaults to the last 30 days when omitted. Tight date windows return more relevant results.

**Q: Is this legal?**
A: Yes — we only extract publicly available data. See the [Legal section](#-is-it-legal-to-scrape-data) below.

**Q: How long does processing take?**
A: ~3–5 seconds per page for paginated operations; ~3–5 seconds for single-row operations.

***

### 🐛 Troubleshooting

**Page returned no rows / empty dataset**

- Verify the input is correct: Weibo ID has 16 digits, UID is numeric, keyword is non-empty
- Check that the post / user still exists on Weibo (try opening `weiboPageUrl` or `userPageUrl` from a result row)
- For fans / followers: not every account exposes these publicly — Weibo respects per-user privacy settings

**HTTP errors / "Data source temporarily unavailable" rows**

- The actor auto-retries transient failures up to 4 times with exponential backoff. If you still see error rows, Weibo is rate-limiting or temporarily unavailable — retry the run after a few minutes.

**16-digit Weibo IDs look truncated in spreadsheet exports**

- Spreadsheet apps (Excel, Google Sheets) auto-cast long integers to scientific notation. The actor preserves them as strings in JSON; in CSV exports, format the `weiboId` column as Text before opening.

**Pagination ends earlier than `maxPages` requested**

- That means the platform served the last page. Check `_page` on the last row. Not all keywords or users have 50 pages of content.

***

### ⚠️ Trademark Disclaimer

This actor is an **independent scraping tool** and is not affiliated with, endorsed by, or sponsored by Sina Corporation or any of its subsidiaries. "Weibo" and "Sina" are used solely in a descriptive sense to identify the public data source the actor reads from. **Weibo®** and **Sina®** are trademarks of their respective owners. All other trademarks are the property of their respective owners.

***

### ⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

***

### ✨ More by SIÁN Agency

Part of the SIÁN Agency Apify portfolio — production-grade scrapers and AI tools used by agencies, research teams, and brands. A few that pair well with Weibo:

**China & E-commerce**

- [Kwai & Kuaishou Scraper](https://apify.com/sian.agency/kwai-kuaishou-scraper?fpr=sian) — China's #2 short-video platform
- [Taobao & Tmall Product Scraper](https://apify.com/sian.agency/taobao-tmall-product-scraper?fpr=sian) — China's #1 marketplace: products, search, shop catalogs, reviews

**Short-Video & Social Media**

- [Best TikTok AI Transcript Extractor](https://apify.com/sian.agency/best-tiktok-ai-transcript-extractor?fpr=sian) — TikTok video → text with metadata
- [Instagram AI Transcript Extractor](https://apify.com/sian.agency/instagram-ai-transcript-extractor?fpr=sian) — Reels & Stories transcription
- [Facebook AI Transcript Extractor](https://apify.com/sian.agency/facebook-ai-transcript-extractor?fpr=sian) — Facebook video → text
- [YouTube Shorts AI Transcript & Metadata Extractor](https://apify.com/sian.agency/youtube-shorts-ai-transcript-and-metadata-extractor?fpr=sian) — Shorts data + transcripts

**Real Estate (Global)**

- [Zillow Property Scraper](https://apify.com/sian.agency/zillow-property-scraper?fpr=sian) · [Airbnb Scraper](https://apify.com/sian.agency/airbnb-property-scraper?fpr=sian) · [Bayut (Dubai)](https://apify.com/sian.agency/bayut-property-scraper?fpr=sian) · [Redfin](https://apify.com/sian.agency/redfin-property-scraper?fpr=sian) · [StreetEasy (NYC)](https://apify.com/sian.agency/streeteasy-property-scraper?fpr=sian) · [Zoopla (UK)](https://apify.com/sian.agency/zoopla-property-scraper?fpr=sian) · [Realtor.com](https://apify.com/sian.agency/realtor-property-scraper?fpr=sian)

[Browse all SIÁN actors →](https://apify.com/sian.agency?fpr=sian)

***

### ⭐ Leave a 5-Star Review

Love this actor? **[Leave a 5-star review here](https://apify.com/sian.agency/weibo-scraper/reviews)** — it helps us build more features for you and lets other teams find it.

***

### 🤝 Support

**Join our active support community**

- For issues or questions, open an issue in the actor's Apify Console Issues tab
- 📧 <apify@sian-agency.online>

***

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)**

# Changelog

This Actor's version history is a separate document: https://apify.com/sian.agency/weibo-scraper/changelog.md

# Actor input Schema

## `operation` (type: `string`):

🎯 **PICK ONE OPERATION PER RUN.** Each run produces one clean dataset matching the chosen mode.

- **📝 Weibo Detail** — deep scrape of a single post by ID (text, location, topics, @-mentions, repost/comment/attitude counts, pics, creator info)
- **👤 User Profile** — full profile by user ID (followers, following, statuses count, verified reason, location, avatar, gender, bio)
- **👥 User Fans** — list of users who follow this account (~20 per page; respects privacy settings)
- **➡️ User Followers** — list of accounts this user follows (~20 per page; respects privacy settings)
- **🔍 Search Weibo** — keyword search across Weibo posts with optional date range, paginated (~14 results/page)

💡 **TIP:** To combine operations, run the actor multiple times with different configurations.

## `weiboId` (type: `string`):

📝 **Required for the `Weibo Detail` operation.**

The numeric Weibo post ID (also called `mid`). You can find it:

- In any mobile Weibo URL: `https://m.weibo.cn/detail/{ID}` → the trailing segment
- In the `weiboId` / `id` field of any search result row

💡 **TIP:** To analyze a batch of posts, run a `Search Weibo` operation first, copy `weiboId` values from the result rows, then run `Weibo Detail` per ID.

⚠️ **Ignored** for User Profile, User Fans, User Followers, and Search operations.

## `userId` (type: `string`):

👤 **Required for `User Profile`, `User Fans`, and `User Followers` operations.**

The numeric Weibo user ID (UID). You can find it:

- In any profile URL: `https://weibo.com/u/{ID}`
- In the `userId` / `user_id` field of any post, search, or fan/follower result row

💡 **TIP:** To build a creator catalog, run `Search Weibo` with a keyword first, then use the top `userId` values to drill into profiles, fans, and followers.

⚠️ **Note:** Some accounts restrict public access to their fan/follower lists — those operations will return an explanatory empty row.

⚠️ **Ignored** for Weibo Detail and Search operations.

## `keyword` (type: `string`):

🔍 **Required for the `Search Weibo` operation.**

Any Weibo search query. Supports Chinese, English, and mixed queries:

- `北京` (Beijing)
- `Tesla`
- `美食` (food)
- `iPhone`

💡 **TIP:** Chinese queries surface native creators and conversations; English/brand queries surface international and brand-mention traffic.

## `startDay` (type: `string`):

📅 **Optional for `Search Weibo`.** Earliest date to include in search results.

Format: `YYYY-MM-DD` (e.g. `2025-04-01`). Defaults to **30 days ago** if left blank.

💡 **TIP:** Tight date windows return more targeted results. Use the start/end pair to track a topic over a specific campaign or news event.

⚠️ **Ignored** for non-search operations.

## `endDay` (type: `string`):

📅 **Optional for `Search Weibo`.** Latest date to include in search results.

Format: `YYYY-MM-DD` (e.g. `2025-05-12`). Defaults to **today** if left blank.

⚠️ **Ignored** for non-search operations.

## `maxPages` (type: `integer`):

📄 **Applies to paginated operations** (User Fans, User Followers, Search Weibo). Ignored for single-record operations (Weibo Detail, User Profile).

- **User Fans:** ~20 users per page
- **User Followers:** ~20 users per page
- **Search Weibo:** ~14 posts per page

💡 **TIP:** Start small (1–3 pages) to preview results before scaling up.

⚠️ Hard cap: 50 pages to prevent runaway runs.

## Actor input object example

```json
{
  "operation": "searchWeibo",
  "weiboId": "5249718969175092",
  "userId": "2760523085",
  "keyword": "北京",
  "startDay": "2025-04-12",
  "endDay": "2025-05-12",
  "maxPages": 5
}
```

# Actor output Schema

## `output` (type: `string`):

Posts, profiles, fans, followers, or search results — one flat row per upstream item with curated camelCase aliases (weiboId, userId, screenName, repostCount, attitudeCount, text, postedAt, weiboPageUrl, userPageUrl, avatarUrl, …) plus the raw upstream fields spread alongside.

## `report` (type: `string`):

HTML run report — row counts, a preview of your first results, an itemized charges statement, failed items with a fix for each, and copy-ready API and MCP snippets. Written even on a fatal crash.

# 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 = {
    "weiboId": "5249718969175092",
    "userId": "2760523085",
    "keyword": "北京"
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/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 = {
    "weiboId": "5249718969175092",
    "userId": "2760523085",
    "keyword": "北京",
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/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 '{
  "weiboId": "5249718969175092",
  "userId": "2760523085",
  "keyword": "北京"
}' |
apify call sian.agency/weibo-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sian.agency/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/lsVei8F82xgKrwXno/builds/B6dpx3CNxbyfnQLnc/openapi.json