Finewisdom API Hub
Home › Use cases › brand mention monitoring API

Brand mention monitoring: 6 platforms plus trending lists, once a day

The cheapest daily brand report is one *_keyword_search call per platform plus the Weibo hot list and the Bilibili/Zhihu/Kuaishou trending lists for signal. 6 searches + 4 lists = ¥1.4/day, ¥42 a month.

Get 20 free callsAll 102 endpoints

Which endpoints to call

EndpointPriceCallsSubtotalPurpose
douyin_keyword_search¥0.1×1¥0.1Douyin: brand and competitor keywords
xhs_note_search¥0.2×1¥0.2Xiaohongshu: recommendations and complaints
weibo_keyword_search¥0.1×1¥0.1Weibo: spread and amplification
bili_keyword_search¥0.1×1¥0.1Bilibili: long-form reputation
zhihu_keyword_search¥0.1×1¥0.1Zhihu: Q&A complaints
ks_keyword_search¥0.3×1¥0.3Kuaishou: lower-tier cities
weibo_hot_search¥0.2×1¥0.2Weibo hot search: did it chart
zhihu_hot_list¥0.1×1¥0.1Zhihu hot list
bili_hot_search¥0.1×1¥0.1Bilibili hot words
ks_hot_list¥0.1×1¥0.1Kuaishou hot list
one day (6 searches + 4 trending lists)¥1.4per full run
30 days¥4230 × ¥1.4

Working code skeleton

Runs as-is once you set TOKEN. Failed and empty calls are skipped, so they cost nothing.

import time, requests
from datetime import date

TOKEN, API = "fw_xxx", "https://finewisdom.top/api"
# keyword parameter name differs per platform: Weibo uses query, the rest use keyword
SEARCH = {"douyin_keyword_search": "keyword", "xhs_note_search": "keyword",
          "weibo_keyword_search": "query", "bili_keyword_search": "keyword",
          "zhihu_keyword_search": "keyword", "ks_keyword_search": "keyword"}
HOT = ["weibo_hot_search", "zhihu_hot_list", "bili_hot_search", "ks_hot_list"]

def call(method, **kw):
    r = requests.get(API, params={"token": TOKEN, "method": method, **kw}, timeout=60).json()
    return r["data"] if r.get("status") == "success" else {}

def daily(brand):
    day = date.today().isoformat()
    rows = []
    for m, pname in SEARCH.items():        # one call per platform, first page only
        d = call(m, **{pname: brand})
        items = d.get("list") or d.get("items") or d.get("data") or []
        rows.append({"date": day, "platform": m.split("_")[0], "count": len(items),
                     "top": items[0] if items else None})
        time.sleep(1.1)
    for m in HOT:                          # trending endpoints take no parameters
        d = call(m)
        rows.append({"date": day, "platform": m, "count": len(d.get("list") or []), "top": None})
        time.sleep(1.1)
    return rows

Gotchas worth knowing

FAQ

Can I query historical trending lists?

No, only the current list. Historical trends require you to store the list every day — which is exactly the value of running a daily job.

How do I align fields across platforms?

Align only the four fields you actually use: content ID, title/body, engagement, publish time. Forcing full field parity across 6 platforms costs more to maintain than it returns.

Related endpoints

weibo_hot_searchParameters, price and exampleszhihu_hot_listParameters, price and examplesdouyin_keyword_searchParameters, price and examplesxhs_note_searchParameters, price and examplesbili_hot_searchParameters, price and examples