{"uid":"cap_gvCaJO5gj2Hd2ja9Uw9tL","slug":"energybilltoolkit-co-uk-10b91117","name":"energybilltoolkit.co.uk Text Metrics Analyze","description":"Aggregate counts, top word frequency, readability, and warnings in one payload.","url":"https://energybilltoolkit.co.uk/text-metrics/api/tools/analyze-text","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":{"text":"Our quarterly energy bill showed a significant increase due to rising wholesale prices and infrastructure levies applied across all domestic tariffs. The analysis revealed that consumption patterns remained stable, but external market factors contributed substantially to the overall cost increase."},"response":{"counts":{"lines":1,"words":40,"headings":0,"sentences":2,"characters":298,"paragraphs":1,"bullet_items":0,"unique_words":37,"non_empty_lines":1,"characters_no_spaces":259,"average_words_per_sentence":20,"average_words_per_paragraph":40},"metric":"aggregate","warnings":[{"code":"short_text","message":"Readability and frequency metrics are unstable below about 100 words.","severity":"caution"},{"code":"few_sentences","message":"Few sentence boundaries detected; readability may be misleading.","severity":"caution"}],"frequency":{"top":[{"count":2,"share":0.064516,"token":"increase"},{"count":1,"share":0.032258,"token":"quarterly"},{"count":1,"share":0.032258,"token":"energy"},{"count":1,"share":0.032258,"token":"bill"},{"count":1,"share":0.032258,"token":"showed"},{"count":1,"share":0.032258,"token":"significant"},{"count":1,"share":0.032258,"token":"due"},{"count":1,"share":0.032258,"token":"rising"},{"count":1,"share":0.032258,"token":"wholesale"},{"count":1,"share":0.032258,"token":"prices"},{"count":1,"share":0.032258,"token":"infrastructure"},{"count":1,"share":0.032258,"token":"levies"},{"count":1,"share":0.032258,"token":"applied"},{"count":1,"share":0.032258,"token":"across"},{"count":1,"share":0.032258,"token":"all"},{"count":1,"share":0.032258,"token":"domestic"},{"count":1,"share":0.032258,"token":"tariffs"},{"count":1,"share":0.032258,"token":"analysis"},{"count":1,"share":0.032258,"token":"revealed"},{"count":1,"share":0.032258,"token":"consumption"}],"top_n":20,"total_tokens":31,"unique_tokens":30,"include_stopwords":false},"readability":{"method":"English Flesch formulas with heuristic syllable counting; directional, not authoritative.","syllables":88,"flesch_reading_ease":0.42,"flesch_kincaid_grade":18.17,"average_syllables_per_word":2.2,"average_sentence_length_words":20}}},"exampleRequest":{"text":"Our quarterly energy bill showed a significant increase due to rising wholesale prices and infrastructure levies applied across all domestic tariffs. The analysis revealed that consumption patterns remained stable, but external market factors contributed substantially to the overall cost increase."},"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_5k1ORb7bhPilgg6qKwY7-","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":"Analyzes a text block and returns aggregate counts, top word frequency, readability scores, and content warnings in a single combined payload.","exampleAgentPrompt":"Can you run a full text analysis on this paragraph — I want to see word counts, top word frequencies, readability score, and any warnings, all in one go: 'Our quarterly energy bill showed a significant increase due to rising wholesale prices and infrastructure levies applied across all domestic tariffs.'","exampleUseCases":null,"resultDescription":"A single JSON payload containing aggregate structural counts (characters, words, sentences, paragraphs), top word frequency rankings, a readability score, and any detected content warnings about the analyzed text.","failureModes":["Empty or missing text body returns a validation error","Extremely long text may exceed payload size limits","Non-UTF-8 encoded content may cause parsing errors","Rate limiting or payment verification failure returns 402 or 429","Malformed JSON request body returns 400"],"whenToPreferThis":"Choose this endpoint when you need a single combined analysis payload covering counts, word frequency, readability, and warnings together — rather than calling separate endpoints for each metric. Ideal for agents that need a quick, comprehensive text quality snapshot without multiple round-trips.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:00.540Z","isFirstParty":false}