# Halowerk Fan Engagement Scorer

> Halowerk Fan Engagement Scorer is a paid API for AI agents from creator.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Computes weighted engagement points per thousand reached accounts (EPM) for one or more audience cohorts, given raw interaction counts and reach.

## Facts

- Endpoint: POST https://creator.halowerk.com/v1/fan-engagement
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-fan-engagement-scorer-9b9166ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sgmz0qdo5X9epZcnhX2iE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability halowerk-fan-engagement-scorer-9b9166ee -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-fan-engagement-scorer-9b9166ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from creator.halowerk.com](https://www.zero.xyz/host/creator.halowerk.com/llms.txt)