{"uid":"cap_0Wz3c7Sj1__V4em7ioC6E","slug":"energybilltoolkit-co-uk-5052e9cd","name":"Word Frequency Analyzer with Stopword Filtering","description":"Return normalized top-N token frequency with optional stopword filtering.","url":"https://energybilltoolkit.co.uk/text-metrics/api/tools/word-frequency","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","description":"Text to measure."},"top_n":{"type":"integer","default":20},"include_stopwords":{"type":"boolean","default":false}}},"responseSchema":null,"example":{"request":{"n":10,"text":"The battery life on this phone is outstanding. The screen is bright and the performance is smooth, but the camera quality is average at best. The design feels premium and the user interface is intuitive.","stopwords":true},"response":{"top":[{"count":1,"share":0.055556,"token":"battery"},{"count":1,"share":0.055556,"token":"life"},{"count":1,"share":0.055556,"token":"phone"},{"count":1,"share":0.055556,"token":"outstanding"},{"count":1,"share":0.055556,"token":"screen"},{"count":1,"share":0.055556,"token":"bright"},{"count":1,"share":0.055556,"token":"performance"},{"count":1,"share":0.055556,"token":"smooth"},{"count":1,"share":0.055556,"token":"camera"},{"count":1,"share":0.055556,"token":"quality"},{"count":1,"share":0.055556,"token":"average"},{"count":1,"share":0.055556,"token":"best"},{"count":1,"share":0.055556,"token":"design"},{"count":1,"share":0.055556,"token":"feels"},{"count":1,"share":0.055556,"token":"premium"},{"count":1,"share":0.055556,"token":"user"},{"count":1,"share":0.055556,"token":"interface"},{"count":1,"share":0.055556,"token":"intuitive"}],"top_n":20,"metric":"frequency","total_tokens":18,"unique_tokens":18,"include_stopwords":false}},"exampleRequest":{"n":10,"text":"The battery life on this phone is outstanding. The screen is bright and the performance is smooth, but the camera quality is average at best. The design feels premium and the user interface is intuitive.","stopwords":true},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hdUMHz93HpBvXxkY-bKy2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns normalized top-N token frequency counts with optional stopword filtering for a given text input.","exampleAgentPrompt":"What are the top 10 most frequent meaningful words in this customer review, ignoring stopwords: 'The battery life on this phone is outstanding. The screen is bright and the performance is smooth, but the camera quality is average at best.'?","exampleUseCases":null,"resultDescription":"A ranked list of up to N tokens, each with an integer count and a normalized frequency share (proportion of total meaningful tokens), sorted by frequency descending.","failureModes":["Empty or missing text field returns an error","n value of 0 or negative may return empty results or an error","Very short texts may return fewer tokens than requested N","Non-UTF8 or malformed text encoding may cause parsing errors","Network timeout for very large text payloads"],"whenToPreferThis":"Use this endpoint when you need deterministic, normalized word frequency analysis on arbitrary text with optional stopword removal — especially useful for content analysis, keyword extraction, review mining, or any task requiring a quantitative breakdown of token distribution without relying on ML models.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:03.227Z","isFirstParty":false}