Weibo Scraper API

The Piloterr Weibo Scraper API lets you extract public data from Weibo as clean, structured JSON — no proxies, headless browsers or HTML parsing to maintain. Endpoints available in production:

• Weibo Post Info API — Retrieve one public Weibo post by post id, including text, images, publish time, engagement counts, and author profile.
• Weibo Search API — Search public Weibo posts by keywords.

Use it for brand monitoring, social listening, influencer research, ad intelligence or content analytics on public data.

Endpoint	Path	Credits	What you get
Weibo Post Info API	/v2/weibo/post/info	2	Retrieve one public Weibo post by post id, including text, images, publish time, engagement counts, and author profile.
Weibo Search API	/v2/weibo/search	2	Search public Weibo posts by keywords. Each post includes the author, text, publish time, engagement counts, image, and video link.

Table of contents

• How it works
• Weibo Post Info API
• Weibo Search API
• Code examples in other languages
• Practical use cases
• Why Piloterr?
• FAQ
• Official SDKs
• Related scrapers
• Support

How it works

1. Create a free Piloterr account and copy your API key from the dashboard.
2. Send a GET (or POST) request to https://api.piloterr.com/v2/... with the header x-api-key: YOUR_API_KEY.
3. Receive structured JSON — Piloterr handles rendering, proxies, retries and parsing.

export PILOTERR_API_KEY="your-api-key"
pip install requests        # Python
# TypeScript: Node.js 18+ (native fetch), run with `npx tsx file.ts`

Every endpoint accepts both GET (query string) and POST (JSON body with the same fields).

Weibo Post Info API

Retrieve one public Weibo post by post id, including text, images, publish time, engagement counts, and author profile.

GET | POST https://api.piloterr.com/v2/weibo/post/info · 2 credits per request · Full reference

Request parameters

Parameter	Type	Required	Description
query	string	✅	Weibo post id.

Python example

import json
import os
import requests

response = requests.get(
    "https://api.piloterr.com/v2/weibo/post/info",
    headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
    params={
        "query": "5062595839264600",
    },
    timeout=120,
)
response.raise_for_status()
data = response.json()

print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])

TypeScript example

type WeiboPostInfo = {
  post?: {
    id?: string;
    url?: string;
    pics?: {
      pid?: string;
      url?: string;
      large?: Record<string, unknown>;
    }[];
    text?: string;
    user?: {
      id?: number;
      verified?: boolean;
      avatar_url?: string;
      screen_name?: string;
      followers_count?: string;
    };
    source?: string;
    video_url?: unknown;
    created_at?: string;
    reposts_count?: number;
    comments_count?: number;
    attitudes_count?: number;
  };
};

const params = new URLSearchParams({
  "query": "5062595839264600",
});

const response = await fetch(`https://api.piloterr.com/v2/weibo/post/info?${params}`, {
  headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);

const data = (await response.json()) as WeiboPostInfo;

console.log(JSON.stringify(data, null, 2).slice(0, 2000));

POST variant

POST https://api.piloterr.com/v2/weibo/post/info
x-api-key: YOUR_API_KEY
Content-Type: application/json

{"query": "5062595839264600"}

Output example

Response shape with placeholder values — field names follow the API reference.

{
  "post": {
    "id": "example",
    "url": "example",
    "pics": [
      {}
    ],
    "text": "example",
    "user": {
      "id": 0,
      "verified": false,
      "avatar_url": "example",
      "screen_name": "example",
      "followers_count": "example"
    },
    "source": "example",
    "video_url": "example",
    "created_at": "example",
    "reposts_count": 0,
    "comments_count": 0,
    "attitudes_count": 0
  }
}

Response fields

Field	Type	Description
post	object
post.id	string
post.url	string
post.pics[]	object[]
post.text	string
post.user	object
post.source	string
post.video_url	object
post.created_at	string
post.reposts_count	integer
post.comments_count	integer
post.attitudes_count	integer

Weibo Search API

Search public Weibo posts by keywords. Each post includes the author, text, publish time, engagement counts, image, and video link.

GET | POST https://api.piloterr.com/v2/weibo/search · 2 credits per request · Full reference

Request parameters

Parameter	Type	Required	Description
query	string	✅	Keywords to search, such as AI.
page	number	—	Page number, starting at 1. Default 1. Page 2 is the next slice of the same keywords.

Python example

import json
import os
import requests

response = requests.get(
    "https://api.piloterr.com/v2/weibo/search",
    headers={"x-api-key": os.environ["PILOTERR_API_KEY"]},
    params={
        "query": "AI",
    },
    timeout=120,
)
response.raise_for_status()
data = response.json()

print(json.dumps(data, indent=2, ensure_ascii=False)[:2000])

TypeScript example

type WeiboSearch = {
  results?: {
    id?: string;
    url?: string;
    text?: string;
    source?: string;
    user_id?: number;
    image_url?: string;
    user_name?: string;
    video_url?: string;
    avatar_url?: string;
    created_at?: string;
    reposts_count?: number;
    comments_count?: number;
    attitudes_count?: number;
  }[];
  pagination?: {
    next?: string;
    page?: number;
    per_page?: number;
    total_pages?: number;
    total_results?: number;
  };
};

const params = new URLSearchParams({
  "query": "AI",
});

const response = await fetch(`https://api.piloterr.com/v2/weibo/search?${params}`, {
  headers: { "x-api-key": process.env.PILOTERR_API_KEY! },
});
if (!response.ok) throw new Error(`Piloterr error ${response.status}: ${await response.text()}`);

const data = (await response.json()) as WeiboSearch;

console.log(JSON.stringify(data, null, 2).slice(0, 2000));

POST variant

POST https://api.piloterr.com/v2/weibo/search
x-api-key: YOUR_API_KEY
Content-Type: application/json

{"query": "AI"}

Output example

Response shape with placeholder values — field names follow the API reference.

{
  "results": [
    {
      "id": "example",
      "url": "example",
      "text": "example",
      "source": "example",
      "user_id": 0,
      "image_url": "example",
      "user_name": "example",
      "video_url": "example",
      "avatar_url": "example",
      "created_at": "example",
      "reposts_count": 0,
      "comments_count": 0,
      "attitudes_count": 0
    }
  ],
  "pagination": {
    "next": "example",
    "page": 0,
    "per_page": 0,
    "total_pages": 0,
    "total_results": 0
  }
}

Response fields

Field	Type	Description
results[]	object[]
results[].id	string
results[].url	string
results[].text	string
results[].source	string
results[].user_id	integer
results[].image_url	string
results[].user_name	string
results[].video_url	string
results[].avatar_url	string
results[].created_at	string
results[].reposts_count	integer
results[].comments_count	integer
results[].attitudes_count	integer
pagination	object
pagination.next	string
pagination.page	integer
pagination.per_page	integer
pagination.total_pages	integer
pagination.total_results	integer

Code examples in other languages

Ready-to-run examples live in the examples/ folder. Each one reads your key from the PILOTERR_API_KEY environment variable.

Language	Post Info	Search
cURL (Bash)	post-info	search
PHP	post-info	search
C#	post-info	search
Go	post-info	search
Java	post-info	search
Ruby	post-info	search
Node.js	post-info	search

Practical use cases

• Brand monitoring — Follow public mentions and engagement around your brand.
• Social listening — Analyse public conversations and trends.
• Influencer research — Qualify public creator profiles and audience metrics.
• Ad intelligence — Study competitors' public ads and creatives.
• Content analytics — Benchmark formats and engagement over time.

Why Piloterr?

• No infrastructure — no proxies, headless browsers or CAPTCHA solving to run yourself.
• Structured JSON — stable, documented fields instead of brittle HTML selectors.
• Pay per request — transparent credit cost per endpoint, failed requests are retried for you.
• One API key, hundreds of sources — Weibo plus many other e-commerce, search and company data endpoints in the Piloterr library.
• Any language — plain HTTPS + JSON, with examples for Python, TypeScript, cURL, PHP, C#, Go, Java, Ruby and Node.js.

FAQ

Is it legal to scrape Weibo?

Collecting publicly available data is generally allowed in many jurisdictions, but rules depend on your country, the data you collect and how you use it. Avoid personal data unless you have a lawful basis, respect the website's terms where they apply, and get legal advice for your specific use case. This is not legal advice.

Do I need proxies or a headless browser?

No. Piloterr handles rendering, proxy rotation and retries on its side. You only send an HTTPS request with your x-api-key header and receive JSON.

How much does a request cost?

Credits per call: /v2/weibo/post/info 2, /v2/weibo/search 2. See the Piloterr website for plans.

What data does the Weibo API return?

Each endpoint returns structured JSON: Weibo Post Info — post, post.id, post.url, post.pics[], post.text, post.user; Weibo Search — results[], results[].id, results[].url, results[].text, results[].source, results[].user_id.

How do I paginate Weibo results?

Use the page parameter and keep requesting while the response indicates more results.

Which languages are supported?

Any language that can make an HTTP request. This README shows Python and TypeScript; the examples/ folder contains cURL, PHP, C#, Go, Java, Ruby and Node.js.

Official SDKs

Use Piloterr from your own language with a typed client:

SDK	Package	Install
Node.js	@piloterr/sdk	npm install @piloterr/sdk
Python	piloterr	pip install piloterr
Go	piloterr-go	go get github.com/piloterr/piloterr-go
.NET	Piloterr	dotnet add package Piloterr
Ruby	piloterr	gem install piloterr
PHP	piloterr/sdk	composer require piloterr/sdk
Java	piloterr-java	build from source, see its README
CLI	@piloterr/cli	npm install -g @piloterr/cli
MCP server	@piloterr/mcp	npx -y @piloterr/mcp

Related scrapers

• Instagram Scraper API
• Kick Scraper API
• Patreon Scraper API
• Pinterest Scraper API
• TikTok Top Ads Scraper API
• X (Twitter) Scraper API
• All Piloterr scrapers on GitHub

Support

• 💬 Join the Piloterr Discord to ask questions and share what you build.
• 📚 Browse the API reference (OpenAPI) and the Piloterr library.
• 🔑 Get your API key.

---

_{Built by Piloterr — web scraping APIs for e-commerce, search, real estate and more, one API key.}

_{Weibo is a trademark of its respective owner. This repository is not affiliated with or endorsed by Weibo. Examples are released under the MIT license.}