# US Brand Offer Evidence Normalizer

> US Brand Offer Evidence Normalizer is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Normalizes and standardizes US brand promotional offer evidence records into a consistent structured format

## Facts

- Endpoint: POST https://api.timzinin.com/api/us-brand-offer-evidence-normalizer
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-brand-offer-evidence-normalizer-a62f3424
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LG5J5pPtHtpBimdcxxhXJ

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 us-brand-offer-evidence-normalizer-a62f3424 -d '<json body>'
```

Example prompt: Normalize this raw offer evidence for Nike (entityId: 'nike-us-001', brandName: 'Nike', country: 'US', domain: 'nike.com') — the evidence is a percent_off deal for 20% off observed at https://nike.com/promo on 2024-11-01, sourced from 'nike_official' with rawTitle 'Nike Holiday Sale' and rawTermsText '20% off sitewide, exclusions apply'.

## When to prefer this

Use this endpoint when you have raw, heterogeneous US brand promotional offer evidence (scraped, aggregated, or user-supplied) and need it normalized into a canonical structured schema. Prefer this over generic ETL tools when your data specifically contains brand offer attributes like percent off, coupon codes, buy-X-get-Y, free shipping, or gift-with-purchase terms that need standardized field mapping and entity attribution.

## Known failure modes

- Missing required entity fields (entityId, brandName, country) returns validation error
- Invalid country code format (not 2-letter ISO) causes schema rejection
- Evidence type or offerKind enum mismatch returns 422 unprocessable entity
- Malformed URL in sourceUrl causes input validation failure
- Empty or missing rawTermsText may yield incomplete normalized output
- Payment not included or insufficient ($0.05 USDC required) returns 402 Payment Required

## How this service works

Pay-per-call data & tool APIs

## Output

Returns normalized, structured offer evidence rows with standardized promotional terms including offer kind, discount values, coupon codes, validity dates, channels, exclusions, geographic scope, member-only flags, and entity attribution — all mapped to a canonical schema for downstream consumption.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "entity",
     "evidence"
    ],
    "properties": {
     "entity": {
      "type": "object",
      "required": [
       "entityId",
       "brandName",
       "legalName",
       "domain",
       "ticker",
       "aliases",
       "country",
       "sourceEntityIds"
      ],
      "properties": {
       "domain": {
        "type": [
         "string",
         "null"
        ],
        "maxLength": 2048
       },
       "ticker": {
        "type": [
         "string",
         "null"
        ],
        "maxLength": 64
       },
       "aliases": {
        "type": "array",
        "items": {
         "type": "string",
         "maxLength": 1024,
         "minLength": 1
        },
        "maxItems": 5
       },
       "country": {
        "type": "string",
        "pattern": "^[A-Z]{2}$"
       },
       "entityId": {
        "type": "string",
        "maxLength": 256,
        "minLength": 1
       },
       "brandName": {
        "type": "string",
        "maxLength": 1024,
        "minLength": 1
       },
       "legalName": {
        "type": [
         "string",
         "null"
        ],
        "maxLength": 1024
       },
       "sourceEntityIds": {
        "type": "array",
        "items": {
         "type": "string",
         "maxLength": 256,
         "minLength": 1
        },
        "maxItems": 10,
        "minItems": 1
       }
      },
      "additionalProperties": false
     },
     "evidence": {
      "type": "object",
      "required": [
       "evidenceType",
       "sourceName",
       "sourceRecordId",
       "sourceUrl",
       "observedAt",
       "rawTitle",
       "rawTermsText",
       "terms",
       "entityAttribution",
       "additionalUrls"
      ],
      "properties": {
       "terms": {
        "type": [
         "object",
         "null"
        ],
        "properties": {
         "endAt": {
          "type": [
           "string",
           "null"
          ],
          "maxLength": 64
         },
         "startAt": {
          "type": [
           "string",
           "null"
          ],
          "maxLength": 64
         },
         "channels": {
          "type": [
           "array",
           "null"
          ],
          "items": {
           "type": "string",
           "maxLength": 256
          },
          "maxItems": 8
         },
         "amountOff": {
          "type": [
          
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-brand-offer-evidence-normalizer-a62f3424/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)