{"name":"koinon-link","version":"1.0.0","transport":"JSON-RPC 2.0 over HTTP POST to this URL","tools":[{"name":"koinon_search_creators","description":"Retrieve creator candidates matching a brief, each with audience signals and a link to full evidence. This returns ONE PAGE: read pagination.has_more and follow pagination.next_cursor to reach the rest — without it you see only the head of the ordering key, which for a follower-bounded query means only the largest accounts. IMPORTANT: this returns candidates for YOU to judge, not a ranked answer. Koinon does NOT screen for content suitability, age-restricted material or brand safety and holds no signal for it — see the response `screening` block. For regulated categories (gambling, alcohol, finance, pharma) you must vet every candidate yourself. The retrieval_score orders candidates for retrieval only — Koinon has measured no reliable ranking advantage and does not claim one. Always read query_understanding.not_applied: constraints that could not be applied as hard filters are listed there. Then fetch each candidate's entity URL for evidence and provenance before recommending anyone."},{"name":"koinon_get_creator","description":"Every entity carries a freshness block; creator profiles are NOT refreshed daily, so read freshness.profile_checked_days_ago before treating followers or engagement as current. Fetch one full creator entity: identity, reach, engagement, content topics, inferred audience, commercial signals, quality signals, evidence excerpts and provenance. Every inferred field carries source_type, confidence, freshness_days and method. audience.status has three values — present, absent (not yet analysed) and inconclusive (analysed, undetermined); do not collapse inconclusive into absent. Contact details are never returned."},{"name":"koinon_market_stats","description":"Creator-market statistics for a segment: how many creators are indexed, the Koinon partner-fit split (NOT a quality ranking), average authenticity (NOT comparable across platforms), what share publish contact details, and how many are flagged as suspected inflated. Optionally filter by industry, platform and country. Returns aggregate numbers only. An unknown value for any filter returns an error, never a zeroed result — so zeros always mean the segment is genuinely empty."},{"name":"koinon_platform_authenticity","description":"Share of suspected inflated-follower accounts and average authenticity score by platform, measured across the Koinon Link index. Useful for deciding how much manual vetting a platform needs."},{"name":"koinon_contactability","description":"Share of creators who publish an email or IM handle, by platform. Drives outreach workload estimates. Contact values themselves are never returned."},{"name":"koinon_audience_functions","description":"Distribution of creator audiences by job function and seniority within an industry, derived from deep content analysis. Answers questions like \"what share of AI creators (industry key: software, sub-niche ai_tools) actually reach practitioners rather than general consumers\"."}],"provenance":{"source":"Koinon Link (koinonlink.com)","publisher":"Vessel AI Lab Hongkong","licence":"CC BY 4.0 — attribution with a link to the source page required","method":"Measured over the Koinon Link index of creator accounts. Not a random sample of any platform: collection is keyword-driven and skews toward software, gaming and e-commerce.","refresh":{"aggregate_statistics":"Aggregate pages are regenerated at least daily; /data/*.json is computed per request over the current index.","fair_score_and_grade":"Recomputed every 24 hours over already-stored observations. A fresh score does NOT mean a fresh observation.","creator_profile_observation":"NOT on a fixed schedule. A creator profile is re-observed only when that account resurfaces in keyword-driven collection, which is capped by a daily API budget. Large accounts on active keywords are re-seen often; the long tail is not. Read freshness.profile_checked_days_ago on every entity or candidate — never assume it is current.","audience_inference":"Re-inferred once the stored persona is older than the persona TTL and budget allows. The TTL is a floor, not a guarantee."},"authenticity_note":"\"suspected_inflated\" is our own screening outcome, computed from a SINGLE profile snapshot: engagement-to-follower ratio where post engagement was collected, otherwise the following/follower ratio, account age, posting volume and platform verification. We do not track follower growth over time. It means \"worth a manual check\", not confirmed fraud. The input set differs by platform (some platforms fall back to a fixed default), so authenticity scores are NOT comparable across platforms.","privacy_note":"Creator entities (identity, reach, inferred audience, evidence) are public. Contact details are never exposed. Creators who requested removal are excluded entirely."}}