{"uid":"cap_1lfM1shJWSm2NH3Bq7jPr","slug":"halowerk-foot-traffic-retail-performance-scorer-bc8f1071","name":"Halowerk Foot Traffic Retail Performance Scorer","description":"Compares supplied visits, mean dwell time and conversions with explicit baselines and combines the three ratios using caller-supplied weights. It does not collect location data, count people, infer demographics or forecast demand. Inputs should be aggregated and lawfully collected.","url":"https://prop.halowerk.com/v1/foot-traffic-retail","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"weights":{"type":"object","required":["visits","dwell","conversion"],"properties":{"dwell":{"type":"number","maximum":1,"minimum":0},"visits":{"type":"number","maximum":1,"minimum":0},"conversion":{"type":"number","maximum":1,"minimum":0}},"additionalProperties":false},"intervals":{"type":"array","items":{"type":"object","required":["interval_id","visits","mean_dwell_minutes","conversions","baseline_visits","baseline_dwell_minutes","baseline_conversion_rate"],"properties":{"visits":{"type":"integer","maximum":1000000000,"minimum":0},"conversions":{"type":"integer","maximum":1000000000,"minimum":0},"interval_id":{"type":"string","maxLength":128,"minLength":1},"baseline_visits":{"type":"number","maximum":1000000000,"minimum":0.001},"mean_dwell_minutes":{"type":"number","maximum":100000,"minimum":0},"baseline_dwell_minutes":{"type":"number","maximum":100000,"minimum":0.001},"baseline_conversion_rate":{"type":"number","maximum":1,"minimum":0.000001}},"additionalProperties":false},"maxItems":10000,"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_Soz9ie_4dDnKg4cc8luLY","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":"Compares observed retail foot-traffic metrics (visits, dwell time, conversions) against caller-supplied baselines and combines the three ratios into a weighted composite score per time interval.","exampleAgentPrompt":"Score last week's retail performance for intervals mon-morning and sat-afternoon: mon-morning had 420 visits (baseline 500), mean dwell 8.2 min (baseline 10), 38 conversions (baseline conversion rate 0.09), and sat-afternoon had 610 visits (baseline 580), dwell 11.5 min (baseline 10.5), 72 conversions (baseline rate 0.11) — weight visits 0.4, dwell 0.3, conversion 0.3.","exampleUseCases":[{"title":"Weekly store performance review","prompt":"Score my store's foot traffic for three intervals this week: tuesday had 300 visits (baseline 350), dwell 7.5 min (baseline 9), 25 conversions (baseline rate 0.08); friday had 520 visits (baseline 480), dwell 10 min (baseline 10), 60 conversions (baseline rate 0.11); saturday had 700 visits (baseline 650), dwell 12 min (baseline 11), 90 conversions (baseline rate 0.13). Weight visits 0.5, dwell 0.25, conversion 0.25."},{"title":"Promotional campaign impact assessment","prompt":"I ran a promo last weekend — can you compare performance to baseline? Saturday: 850 visits (baseline 600), dwell 9 min (baseline 8.5), 110 conversions (baseline rate 0.10); Sunday: 780 visits (baseline 580), dwell 8 min (baseline 8), 95 conversions (baseline rate 0.09). Use equal weights of 0.33 for all three metrics."},{"title":"Multi-location portfolio benchmarking","prompt":"Compare four store intervals to their individual baselines and give me a weighted score for each: store-A had 400 visits (baseline 420), dwell 6 min (baseline 7), 30 conversions (baseline rate 0.075); store-B had 600 visits (baseline 550), dwell 11 min (baseline 10), 70 conversions (baseline rate 0.12); store-C had 200 visits (baseline 250), dwell 5 min (baseline 6), 18 conversions (baseline rate 0.09); store-D had 900 visits (baseline 850), dwell 14 min (baseline 13), 120 conversions (baseline rate 0.14). Weight visits 0.4, dwell 0.2, conversion 0.4."}],"resultDescription":"For each submitted interval, the endpoint returns the individual ratios (visits/baseline, dwell/baseline, conversion/baseline) and a single weighted composite score combining all three ratios according to the caller-supplied weights, enabling direct comparison of performance across intervals.","failureModes":["Weights that do not sum to a valid range may be rejected or yield unintuitive scores","baseline values of zero are not permitted (minimum 0.001); supplying zero baselines returns a validation error","interval_id strings exceeding 128 characters are rejected","submitting more than 10,000 intervals in one call returns a payload-too-large error","missing required fields (visits, mean_dwell_minutes, conversions, any baseline) result in schema validation errors","non-numeric or negative metric values are rejected"],"whenToPreferThis":"Choose this endpoint when you have already aggregated retail foot-traffic data and need a fast, deterministic weighted composite score against explicit baselines — without any data collection, demographic inference, or forecasting. It is ideal for post-hoc performance reporting, comparing time intervals, or feeding scores into a broader analytics pipeline. Prefer alternatives if you need raw data ingestion, predictive modelling, or demographic segmentation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:46:16.318Z","isFirstParty":false}