Getting Started

Welcome to the Jambing API. Our API allows you to programmatically trigger deep sentiment analysis on any product or topic across major Chinese social media platforms like Bilibili and Zhihu.

Use this API to monitor brand reputation, discover consumer pain points, and gain market intelligence directly from 1.4 billion Chinese consumers.

Authentication

Authenticate your requests by including your secret API key in the X-API-KEY header.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

BASE URL

https://jambing.cc/apidoc

Create Analysis

POST /v1/analyze

Submit a new keyword for sentiment analysis. The system will start collecting data and processing it in the background.

Request Body

Parameter	Type	Description
keyword	string	The product or topic name to analyze (English or Chinese).
platforms	array	List of platforms to scan. Defaults to `["bilibili", "zhihu"]`.
lang	string	Output language for the analysis (`"zh"` or `"en"`). Defaults to `"zh"`.

PYTHON EXAMPLE

import requests

url = "https://jambing.cc/apidoc/v1/analyze"
headers = {
    "X-API-KEY": "your_api_key_here",
    "Content-Type": "application/json"
}
payload = {
    "keyword": "iPhone 16",
    "platforms": ["bilibili", "zhihu"],
    "lang": "en"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
        

CURL EXAMPLE

curl -X POST https://jambing.cc/apidoc/v1/analyze \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "iPhone 16", "lang": "en"}'
        

Get Report

GET /v1/report/{task_id}

Retrieve the status and structured results of an analysis task. Results include sentiment dimensions, evidence from social media, and full reports.

Path Parameters

Parameter	Type	Description
task_id	integer	The ID of the task returned by the analyze endpoint.

PYTHON EXAMPLE

import requests

url = "https://jambing.cc/apidoc/v1/report/123"
headers = {"X-API-KEY": "your_api_key_here"}

response = requests.get(url, headers=headers)
print(response.json())
        

# JSON Response Example
{
  "task_id": 123,
  "status": "completed",
  "analysis_results": [
    {
      "dimension": "Positive Feedback",
      "content": "Users love the titanium finish...",
      "evidence": "Mentioned in 45 Bilibili videos"
    }
  ]
}
        

Pricing Plans

Choose the plan that fits your analysis needs. All plans include access to both Bilibili and Zhihu data sources.

Free Beta 10 calls / day $0

Developer Pro 100 calls / day $9 / mo