{"uid":"cap_sgmz0qdo5X9epZcnhX2iE","slug":"halowerk-fan-engagement-scorer-9b9166ee","name":"Halowerk Fan Engagement Scorer","description":"Weights likes, comments, shares, saves and clicks, divides by supplied reach, and reports cohort and aggregate points per thousand reached accounts. It does not access a platform, distinguish authentic from manipulated activity, measure sentiment or predict revenue.","url":"https://creator.halowerk.com/v1/fan-engagement","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cohorts":{"type":"array","items":{"type":"object","required":["name","reach","likes","comments","shares","saves","clicks"],"properties":{"name":{"type":"string","maxLength":128,"minLength":1},"likes":{"type":"integer","maximum":1000000000000,"minimum":0},"reach":{"type":"integer","maximum":1000000000000,"minimum":1},"saves":{"type":"integer","maximum":1000000000000,"minimum":0},"clicks":{"type":"integer","maximum":1000000000000,"minimum":0},"shares":{"type":"integer","maximum":1000000000000,"minimum":0},"comments":{"type":"integer","maximum":1000000000000,"minimum":0}},"additionalProperties":false},"maxItems":1000,"minItems":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NCadftc9dbmDuK1AMfiUn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes weighted engagement points per thousand reached accounts (EPM) for one or more audience cohorts, given raw interaction counts and reach.","exampleAgentPrompt":"Calculate the weighted fan engagement score for two cohorts: 'Gen Z followers' with 50,000 reach, 4,200 likes, 310 comments, 890 shares, 1,100 saves, and 2,300 clicks; and 'Millennial followers' with 30,000 reach, 2,100 likes, 140 comments, 420 shares, 600 saves, and 1,800 clicks — give me the points per thousand for each cohort and overall.","exampleUseCases":[{"title":"Influencer campaign performance report","prompt":"I just wrapped a brand campaign and need to score engagement across three audience segments: 'Core Fans' (reach 80,000, likes 9,500, comments 720, shares 1,400, saves 2,100, clicks 5,300), 'Casual Followers' (reach 120,000, likes 4,200, comments 180, shares 300, saves 410, clicks 1,900), and 'New Reach' (reach 200,000, likes 1,800, comments 90, shares 150, saves 200, clicks 800). Can you give me the weighted EPM for each cohort and an aggregate?"},{"title":"A/B content format comparison","prompt":"I posted two content formats last week and want to see which drove better engagement per thousand reached — 'Reel' had 45,000 reach, 6,100 likes, 480 comments, 900 shares, 1,200 saves, 3,400 clicks; 'Carousel' had 38,000 reach, 5,800 likes, 620 comments, 750 shares, 2,100 saves, 2,900 clicks. Score them both and tell me which performed better."},{"title":"Monthly creator benchmarking","prompt":"Give me the fan engagement points per thousand for my three main audience cohorts this month: 'US Subscribers' (reach 95,000, likes 11,200, comments 830, shares 1,600, saves 3,400, clicks 7,100), 'EU Subscribers' (reach 42,000, likes 4,100, comments 310, shares 580, saves 1,200, clicks 2,800), and 'APAC Subscribers' (reach 28,000, likes 2,900, comments 195, shares 390, saves 870, clicks 1,500)."}],"resultDescription":"Returns a weighted engagement points-per-thousand (EPM) score for each named cohort and an overall aggregate score, calculated by applying configurable weights to likes, comments, shares, saves, and clicks, then dividing by reach and scaling to a per-1000 basis.","failureModes":["reach value of 0 or missing causes division-by-zero rejection (minItems:1, minimum:1 enforced)","cohort array exceeding 1000 items rejected","negative interaction counts rejected (minimum:0)","interaction counts exceeding 1 trillion rejected (maximum:1000000000000)","missing required cohort fields (name, reach, likes, comments, shares, saves, clicks) cause validation error","malformed JSON body returns 400","payment not included or insufficient USDC triggers 402"],"whenToPreferThis":"Choose this endpoint when you need a fast, deterministic, weighted engagement-per-thousand metric computed from raw interaction counts you already have — especially when comparing multiple audience cohorts in a single call. It is ideal for creator analytics pipelines, influencer reporting, and content benchmarking where you supply the raw numbers and want a normalized EPM score without requiring platform API access. Do not use it if you need live platform data retrieval, sentiment analysis, fraud/authenticity detection, or revenue prediction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:18.727Z","isFirstParty":false}