{"uid":"cap_ZQEG9xMnB8SPYaoR-aeT7","slug":"hacker-news-trending-keywords-0919614c","name":"Hacker News Trending Keywords","description":"Trending keywords across current Hacker News stories: terms ranked by how many titles use them, with example titles.","url":"https://hacker-news.x402tookit.com/hn-trending-topics?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"top":{"type":"integer","description":"Terms to return 1 to 20 (default 10)"},"list":{"type":"string","description":"top (default), new, best, ask or show"},"stories":{"type":"integer","description":"Stories to analyse 5 to 15 (default 15)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"list":{"type":["null","string"]},"terms":{"type":["array","null"],"items":{"type":"object","properties":{"term":{"type":["null","string"]},"share":{"type":["null","number"]},"titles":{"type":["null","number"]},"totalScore":{"type":["null","number"]},"exampleTitles":{"type":["array","null"],"items":{"type":"string"}}}}},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"termsReturned":{"type":["null","number"]},"titlesAnalysed":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JG5bTzJH99gTHV0S_XxMY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the most frequently occurring keywords across current Hacker News stories, ranked by title usage frequency with example titles.","exampleAgentPrompt":"What are the top 10 trending keywords across the current Hacker News front page stories right now? Analyze the top 15 stories and show me which terms appear most often along with example titles.","exampleUseCases":[{"title":"Daily tech pulse briefing","prompt":"Give me a quick summary of what's buzzing on Hacker News today — what are the top 10 keywords showing up across the best stories right now?"},{"title":"Startup pitch topic research","prompt":"I'm preparing a pitch and want to know what tech topics are dominating Hacker News this week. Can you pull the trending terms from the top 15 HN stories and show me their frequency?"},{"title":"Newsletter content planning","prompt":"I write a weekly tech newsletter and need inspiration — what are the 15 most common keywords across today's new Hacker News stories so I can see what's resonating with the developer community?"}],"resultDescription":"A JSON object containing a timestamp, the list type analyzed, number of titles analyzed, and an array of trending terms each with: the keyword, share percentage of titles it appears in, count of titles containing it, a total relevance score, and example HN story titles that use the term. Also includes a plain-language summary and any degraded-mode warnings.","failureModes":["HN API unavailability causes degraded mode with partial results or null data","Requesting more than 20 terms or more than 15 stories returns a validation error","Invalid list type value causes an error — must be top, new, best, ask, or show","Very few stories available may reduce the meaningfulness of term frequency rankings"],"whenToPreferThis":"Choose this endpoint when you need a fast, keyword-level pulse of what topics are currently popular on Hacker News without reading individual stories. Ideal for trend monitoring, content planning, or competitive intelligence where you want the signal distilled from multiple HN stories at once. Prefer this over the search endpoint when you don't have a specific query in mind and want open-ended discovery of what's trending now.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:44.675Z","isFirstParty":false,"canonicalSlug":"hacker-news-trending-keywords-0919614c"}