{"uid":"cap_zeig2K3cQR3oezhawAbAe","slug":"us-map-retail-evidence-api-94d3f397","name":"US Map Retail Evidence API","description":"Pay-per-call data & tool APIs","url":"https://api.timzinin.com/api/us-map-retail-evidence?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"rows":{"type":"array","items":{"$ref":"#/definitions/row"},"maxItems":100,"minItems":1},"options":{"$ref":"#/definitions/options"},"watchId":{"$ref":"#/definitions/bazaarShared0"},"datasetId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9_-]{0,99}$"},"requestId":{"$ref":"#/definitions/bazaarShared0"},"schemaVersion":{"const":"1.0"},"watchUniverse":{"type":"array","items":{"type":"string","pattern":"^(productId|upc|asin|usItemId|tcin):.+$"},"maxItems":100,"minItems":1},"datasetCoverage":{"type":"object","required":["closed","expectedItems"],"properties":{"closed":{"const":true},"expectedItems":{"type":"integer","maximum":100,"minimum":0}},"additionalProperties":false},"openrouterApiKey":{"type":"string","minLength":1}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.08","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.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8lort9HrTPC_JTMHGppzs","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves retail evidence and product data mapped to US retail locations, accepting product identifiers and returning structured retail presence information","exampleAgentPrompt":"Pull US retail evidence for these 5 products — UPC:012345678901, ASIN:B08N5WRWNW, usItemId:123456789, TCIN:87654321, and productId:abc123 — using dataset ID 'cpg-q2-2024' and mark the dataset as closed with 5 expected items.","exampleUseCases":[{"title":"CPG brand retail distribution audit","prompt":"I need to check which US retailers are carrying our new snack line — here are 20 UPCs: [upc:012345678901, upc:012345678902, ...]. Use dataset ID 'snack-line-audit' and treat it as a closed dataset expecting 20 items."},{"title":"Competitor product retail presence mapping","prompt":"Can you look up US retail evidence for these 10 ASINs from our competitor's product catalog? Dataset ID should be 'competitor-watch-q3', closed dataset with 10 expected items: ASIN:B08N5WRWNW, ASIN:B09G9HD66R, ..."},{"title":"Retail watchlist monitoring for key SKUs","prompt":"Set up a retail evidence lookup for my watchlist — 15 items including productId:sku-001, usItemId:987654321, and TCIN:11223344. Use watch ID 'priority-skus-2024', dataset ID 'watchlist-jan', closed with 15 expected items."}],"resultDescription":"Returns structured retail evidence records for each submitted product identifier, indicating retail presence, availability, and location data across US retail channels such as Walmart, Target, and Amazon. The response is organized per row/product input.","failureModes":["Invalid product identifier format (must match productId|upc|asin|usItemId|tcin pattern) returns validation error","Exceeding 100 rows or 100 watchUniverse items returns a schema validation error","Missing required schemaVersion '1.0' causes request rejection","Empty rows array (minItems:1 not met) causes a bad request error","Payment failure or insufficient USDC balance returns HTTP 402","Unknown or malformed datasetId pattern causes rejection"],"whenToPreferThis":"Choose this endpoint when you need structured retail evidence for specific US retail locations tied to product identifiers like UPCs, ASINs, Walmart item IDs, or Target TCINs. It is ideal for CPG brands, market researchers, and e-commerce analysts who need pay-per-call, on-demand retail presence data without a subscription. Prefer this over general web scraping or third-party syndicated data services when you need programmatic, per-product retail evidence at low cost ($0.08/call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:07.870Z","isFirstParty":false,"canonicalSlug":"us-map-retail-evidence-api-94d3f397"}