{"uid":"cap_LG5J5pPtHtpBimdcxxhXJ","slug":"us-brand-offer-evidence-normalizer-a62f3424","name":"US Brand Offer Evidence Normalizer","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/us-brand-offer-evidence-normalizer","method":"POST","headers":{},"bodySchema":{"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":["object","null"],"required":["value","currency"],"properties":{"value":{"type":"number","maximum":1000000000000,"minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"additionalProperties":false},"geography":{"type":["string","null"],"maxLength":1024},"offerKind":{"enum":["percent_off","amount_off","buy_x_get_y","free_shipping","gift_with_purchase","bundle","coupon_code","price_drop","other"],"type":"string"},"couponCode":{"type":["string","null"],"maxLength":256},"exclusions":{"type":["array","null"],"items":{"type":"string","maxLength":1024},"maxItems":32},"memberOnly":{"type":["boolean","null"]},"percentOff":{"type":["number","null"],"maximum":100,"minimum":0},"buyQuantity":{"type":["integer","null"],"maximum":1000000,"minimum":1},"getQuantity":{"type":["integer","null"],"maximum":1000000,"minimum":1},"newCustomerOnly":{"type":["boolean","null"]},"minPurchaseAmount":{"type":["object","null"],"required":["value","currency"],"properties":{"value":{"type":"number","maximum":1000000000000,"minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"additionalProperties":false}},"additionalProperties":false},"rawTitle":{"type":["string","null"],"maxLength":1024},"sourceUrl":{"type":"string","pattern":"^https://","maxLength":1024},"observedAt":{"type":"string","maxLength":64},"sourceName":{"type":"string","maxLength":1024,"minLength":1},"evidenceType":{"enum":["ad","offer","coupon","landing_page"],"type":"string"},"rawTermsText":{"type":["string","null"],"maxLength":4096},"additionalUrls":{"type":"array","items":{"type":"string","pattern":"^https://","maxLength":1024},"maxItems":4},"sourceRecordId":{"type":"string","maxLength":1024,"minLength":1},"suppliedOfferId":{"type":["string","null"],"maxLength":256},"entityAttribution":{"type":["object","null"],"required":["status","proofType","proofValue","sourceEntityId","proofUrl","proofDomain","merchantId","adAccountId","officialSourceId"],"properties":{"status":{"type":"string","const":"verified_by_source"},"proofUrl":{"type":"string","pattern":"^https://","maxLength":1024},"proofType":{"enum":["first_party_domain","merchant_id_and_domain","official_ad_account","source_entity_id","official_link"],"type":"string"},"merchantId":{"type":["string","null"],"maxLength":1024},"proofValue":{"type":"string","maxLength":2048,"minLength":1},"adAccountId":{"type":["string","null"],"maxLength":1024},"proofDomain":{"type":["string","null"],"maxLength":1024},"sourceEntityId":{"type":"string","maxLength":256,"minLength":1},"officialSourceId":{"type":["string","null"],"maxLength":1024}},"additionalProperties":false}},"additionalProperties":false}},"additionalProperties":false},"maxItems":100,"minItems":1},"options":{"type":"object","properties":{"labels":{"enum":["off","byok"],"type":"string"},"maxItems":{"type":"integer","maximum":100,"minimum":1},"analysisModel":{"type":"string","maxLength":200,"minLength":1}},"additionalProperties":false},"datasetId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,99}$","maxLength":100,"minLength":1},"requestId":{"type":"string","pattern":"^[A-Za-z0-9._:-]+$","maxLength":80,"minLength":1},"schemaVersion":{"enum":["1.0"],"type":"string"},"openrouterApiKey":{"type":"string","maxLength":4096,"minLength":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GQF5B3zYt6QJcbXjA4oCa","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Normalizes and standardizes US brand promotional offer evidence records into a consistent structured format","exampleAgentPrompt":"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'.","exampleUseCases":[{"title":"Retailer promo feed normalization","prompt":"I've scraped coupon data from several US retailer sites and need it normalized — can you process this batch for BestBuy (entityId: 'bestbuy-001', country: 'US', domain: 'bestbuy.com') with a percent_off evidence record: 15% off electronics observed at https://bestbuy.com/deals on 2024-12-01, source 'bestbuy_official', rawTitle 'Holiday Deals', rawTermsText '15% off select electronics, exclusions apply'?"},{"title":"Coupon code evidence standardization","prompt":"Normalize this coupon code offer for Gap (entityId: 'gap-us-002', brandName: 'Gap', country: 'US', domain: 'gap.com'): it's a coupon_code type deal with code SAVE30 for 30% off, observed at https://gap.com/coupons on 2024-10-15, sourced from 'gap_promo_feed', rawTitle 'Fall Savings Event', rawTermsText '30% off full-price styles with code SAVE30, member only'."},{"title":"Aggregator deal data cleaning pipeline","prompt":"I'm building a deal aggregator and need to standardize offer evidence from multiple brands — please normalize this free_shipping offer for Amazon (entityId: 'amazon-us-003', brandName: 'Amazon', country: 'US', domain: 'amazon.com') observed at https://amazon.com/shipping on 2024-11-20, source 'amazon_deals', rawTitle 'Free Shipping Event', rawTermsText 'Free shipping on orders over $25, select items'."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:50:53.227Z","isFirstParty":false}