{"uid":"cap_p_wlg3hRoQrSjRL6659pE","slug":"dopaminedesk-hacker-news-top-stories-api-63c2d250","name":"DopamineDesk Hacker News Top Stories API","description":"Fetch current top-story metadata and discussion links from the official Hacker News Firebase API.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/hacker_news_top","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","properties":{"limit":{"type":"integer","description":"Number of stories to return (default 30)."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","source","fetched_at","count","data","marketplace_metadata"],"properties":{"data":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"source":{"type":"string"},"success":{"type":"boolean"},"fetched_at":{"type":"string"},"marketplace_metadata":{"type":"object","required":["data_mode","billable","availability","source"],"properties":{"source":{"type":"string"},"billable":{"type":"boolean"},"data_mode":{"type":"string"},"availability":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"data":["[nested detail omitted from the challenge header; see the full example in /openapi.json]"],"count":2,"source":"Hacker News Firebase API","success":true,"fetched_at":"2026-08-07T07:32:38.144Z","marketplace_metadata":{"source":"Hacker News Firebase API","billable":true,"data_mode":"live_source","availability":"operational"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ylzl5ibrTzO-pfgfK1P2r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current top stories from Hacker News, including title, URL, author, points, and comment count.","exampleAgentPrompt":"Can you grab the top 10 stories from Hacker News right now and show me the titles, links, and how many points each one has?","exampleUseCases":[{"title":"Morning tech briefing for developers","prompt":"Pull the top 20 Hacker News stories this morning and summarize the titles and point counts so I can quickly see what the dev community is buzzing about."},{"title":"Trending topic monitoring for content team","prompt":"Fetch the current top 30 Hacker News posts — I want to see what topics are trending so we can decide what to write about this week."},{"title":"Curating links for a newsletter","prompt":"Get me the top 15 stories from Hacker News today including the URLs and author names — I'm putting together our weekly developer newsletter and need the best links."}],"resultDescription":"Returns a JSON array of top Hacker News stories, each containing an integer story ID, title string, URL, author username, integer points score, and integer comment count. The number of stories returned is controlled by the optional `limit` parameter (default 30).","failureModes":["Invalid or out-of-range limit value returns a validation error","Upstream Hacker News data unavailable may cause empty or partial results","Network timeout if the upstream feed is slow","Payment/x402 settlement failure blocks the request before data is returned"],"whenToPreferThis":"Choose this endpoint when you need live, ranked Hacker News front-page data in a single pay-per-call request without managing your own scraper or API key. It is ideal for agents that need fresh tech-community trending content on demand and want USDC micropayment settlement via x402 on Base rather than subscription billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:46:35.657Z","isFirstParty":false}