Finewisdom API Hub
Home › Use cases › influencer vetting API

Influencer vetting: everything you need on one account before you pay

Three things decide whether a creator is worth paying: audience size (*_user_info), posting cadence (*_user_posts / xhs_user_notes) and real engagement (counts on the content itself). Across 3 platforms that is 10 calls, ¥1.4 per creator.

Get 20 free callsAll 102 endpoints

Which endpoints to call

EndpointPriceCallsSubtotalPurpose
douyin_author_info¥0.1×1¥0.1Douyin: followers, likes, verification
xhs_user_info¥0.2×1¥0.2Xiaohongshu: followers, note count, likes
xhs_user_notes¥0.2×3¥0.6Recent notes (cursor pagination)
bili_user_info¥0.1×1¥0.1Bilibili: followers, verification
bili_user_posts¥0.1×2¥0.2Upload list, to compute cadence
weibo_user_posts¥0.1×2¥0.2Recent posts
per creator (profile + post list on 3 platforms)¥1.4per full run
50 creators¥7050 × ¥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

TOKEN, API = "fw_xxx", "https://finewisdom.top/api"

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 vet_xhs(userid):
    info = call("xhs_user_info", user_id=userid)
    posts, cursor = [], None
    for _ in range(3):
        d = call("xhs_user_notes", userid=userid, **({"cursor": cursor} if cursor else {}))
        batch = d.get("list") or d.get("notes") or []
        if not batch:
            break
        posts += batch
        cursor = d.get("_next_offset") or d.get("cursor")
        if not cursor:
            break
        time.sleep(1.1)
    likes = [p.get("liked_count") or 0 for p in posts]
    fans = info.get("fans") or info.get("fans_count") or 0
    return {
        "user_id": userid,
        "fans": fans,
        "posts_recent": len(posts),
        "avg_likes": round(sum(likes) / len(likes), 1) if likes else 0,
        "engagement": round((sum(likes) / len(likes) / fans) * 100, 2) if likes and fans else None,
    }

Gotchas worth knowing

FAQ

Can I get creator rate cards?

No. Pricing is commercial information the platforms do not publish. The APIs give you content and engagement, which is what you need to judge whether a quote is fair.

How do I screen 500 creators?

Call user_info only (¥0.1–0.3 each) for all 500, filter on followers and verification, then pull post lists for the top 20%. Screening 500 profiles costs roughly ¥60–150.

Related endpoints

douyin_author_infoParameters, price and examplesxhs_user_infoParameters, price and examplesxhs_user_notesParameters, price and examplesbili_user_postsParameters, price and examplesweibo_user_postsParameters, price and examples