{"uid":"cap_q4S1yPOPbI5X-YZo1-TYH","slug":"dopaminedesk-news-sentiment-api-c2bf2b9f","name":"DopamineDesk News Sentiment API","description":"Fetch recent Hacker News stories for a topic and apply a transparent keyword-lexicon sentiment score.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/news_sentiment","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":["entity"],"properties":{"days":{"type":"integer","description":"Lookback period in days."},"entity":{"type":"string","description":"Company, brand, or person name."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","source","analysis_method","fetched_at","topic","articles_analyzed","sentiment_score","sentiment_label","articles","marketplace_metadata"],"properties":{"topic":{"type":"string"},"source":{"type":"string"},"success":{"type":"boolean"},"articles":{"type":"array","items":{"type":"string"}},"fetched_at":{"type":"string"},"analysis_method":{"type":"string"},"sentiment_label":{"type":"string"},"sentiment_score":{"type":"integer"},"articles_analyzed":{"type":"integer"},"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":{"topic":"Microsoft","source":"Hacker News Algolia API","success":true,"articles":["[nested detail omitted from the challenge header; see the full example in /openapi.json]"],"fetched_at":"2026-08-07T07:32:38.571Z","analysis_method":"transparent keyword-lexicon sentiment v1","sentiment_label":"NEUTRAL","sentiment_score":0,"articles_analyzed":10,"marketplace_metadata":{"source":"Hacker News Algolia API plus deterministic lexicon","billable":true,"data_mode":"live_source","availability":"operational"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mImRGrmRxizvvYIHsN0ZP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a sentiment score, label, and top articles for a named company, brand, or person based on recent news coverage.","exampleAgentPrompt":"What's the current news sentiment for Microsoft over the last 7 days — is it bullish or bearish, and which articles are driving it?","exampleUseCases":[{"title":"Pre-investment due diligence check","prompt":"Before I buy shares in Nvidia, can you pull the news sentiment for the past 30 days and tell me if coverage is mostly positive or negative, with the top articles?"},{"title":"Brand reputation monitoring","prompt":"What does the news sentiment look like for Nike right now? I want to know if recent press is positive or negative and see which stories are getting the most coverage."},{"title":"Competitive intelligence snapshot","prompt":"Run a news sentiment check on Apple and tell me the overall score, whether it's bullish or bearish, and how many articles came up in the last 14 days."}],"resultDescription":"A JSON object containing the entity name, an overall sentiment score (0–1 float), a human-readable sentiment label (e.g. 'Bullish/Positive'), a count of articles analyzed, and an array of top articles each with title, source, and individual sentiment score.","failureModes":["Missing or unrecognized entity name returns an error or empty results","Lookback period too long may return limited data if news coverage is sparse","Rate limits or payment failures return 402 or 429 errors","Ambiguous entity names (e.g. common words) may return mixed or inaccurate results","No recent news coverage for the entity may yield low article count and unreliable sentiment"],"whenToPreferThis":"Choose this endpoint when you need a quick, quantified news sentiment signal for a specific company, brand, or public figure — especially for pre-investment research, brand health checks, or competitive intelligence. It is best when you want both a numeric score and labeled sentiment backed by real article references, rather than raw social media sentiment or stock price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:52:11.342Z","isFirstParty":false}