{"openapi":"3.1.0","info":{"title":"know.fast","version":"1.0.0","description":"Send a link. Know it. Any URL — article, YouTube video, X post, podcast episode, paper, PDF, GitHub repo — becomes a durable, cited knowledge page plus a token-efficient markdown packet built for agent relay. Links are unique: anything any agent has ever known answers instantly from the shared knowledge base; first-ever links are processed once, for everyone (transcription absorbed — a 2-hour podcast is still one cent). Flat $0.01 per link.","x-guidance":"POST https://know.fast/v1/know with {\"url\":\"…\"} (aliases: POST /, /v1/analyze). Known links answer instantly with `packet` — a token-efficient markdown knowledge packet (title, summary, key claims and facts with citations) — ANSWER DIRECTLY FROM IT, no second fetch. First-ever media links return deferred=true with a public statusUrl (no auth) — poll 20-30s until knowledgeReady, then GET markdownUrl. Payment: no key, no signup — pay the 402 challenge from any MPP wallet (method=tempo, Tempo USDC), per call or via a session; native Base-USDC x402 clients use POST /v1/x402/know. The first paid call returns a durable rk_ key (agentApiKey) in the response body — reuse it as Authorization: Bearer. Always relay viewerUrl to the end user — it is a durable, citable knowledge page. Full contract: https://know.fast/agent.txt","contact":{"email":"j@horyzon.co","url":"https://know.fast"}},"servers":[{"url":"https://know.fast"}],"x-service-info":{"name":"know.fast","categories":["data","search","web"],"docs":{"homepage":"https://know.fast","apiReference":"https://know.fast/agent.txt","llms":"https://know.fast/llms.txt"}},"paths":{"/v1/know":{"post":{"operationId":"know","summary":"Send a link, get a cited knowledge packet — flat $0.01","description":"ONE CENT FOR EVERYTHING, ALWAYS AN INSTANT ANSWER. A link anyone has already known answers instantly ({\"cached\": true} plus the inline `packet`); a first-ever link answers instantly too, with a deferred run ({\"deferred\": true, \"knowledgeReady\": false} plus statusUrl/markdownUrl/viewerUrl) — reply to your user right away and share viewerUrl, poll statusUrl (public JSON, no auth) until knowledgeReady, then GET markdownUrl for the packet. Articles land in about a minute; video/podcast in minutes (we absorb transcription costs). Every knowledge page is durable and citable, and every read of a known link is a cache hit for every future agent — the knowledge base compounds. Pass {\"fresh\": true} to re-read changed content (same price). Failures are not charged and dead links answer free from the failure cache.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"The link to know — article, YouTube video, X/Twitter post or thread, podcast episode (Spotify/Apple/Overcast), paper, PDF, or GitHub repo"},"lang":{"type":"string","description":"Optional language hint (e.g. \"en\")"},"fresh":{"type":"boolean","description":"Re-read from scratch because the content changed (same flat price)"},"defer":{"type":"boolean","description":"Accepted for compatibility — first-ever links always defer on know.fast, so this flag is a no-op here"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"mpp":{"method":"tempo","intent":"charge","currency":"0x20c000000000000000000000b9537d11c60e8b50"}}]},"responses":{"200":{"description":"The knowledge. Known links: cached=true, knowledgeReady=true, and `packet` inline — answer directly from it. First-ever articles: same shape, cached=false. First-ever media: deferred=true with statusUrl (public JSON, no auth) and markdownUrl — poll statusUrl until knowledgeReady, then GET markdownUrl.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"cached":{"type":"boolean","description":"true when answered instantly from the shared knowledge base"},"kind":{"type":"string","enum":["article","video","podcast"]},"title":{"type":"string"},"runId":{"type":"string","description":"Durable id of the knowledge page"},"status":{"type":"string"},"costUsd":{"type":"number","description":"The flat price actually charged"},"knowledgeReady":{"type":"boolean","description":"true when `packet` is present"},"packet":{"type":"string","description":"Token-efficient markdown knowledge packet — answer directly from it"},"deferred":{"type":"boolean","description":"true for first-ever media; poll statusUrl"},"statusUrl":{"type":"string","description":"Public JSON status endpoint (no auth)"},"viewerUrl":{"type":"string","description":"Durable, citable public knowledge page — relay to the user"},"markdownUrl":{"type":"string","description":"The knowledge packet as raw markdown"}},"required":["url","viewerUrl"]}}}},"402":{"description":"Payment Required — MPP Payment challenge in WWW-Authenticate (method=tempo; charge or session intent), plus body guidance for callers that cannot satisfy it"}}}}}}