{"uid":"cap_Jq_adDwdIc7t7AtzcWKSK","slug":"friday-seller-tools-competitor-change-monitor-spec-5c3219fb","name":"Friday Seller Tools – Competitor Change Monitor Spec","description":"Instant, low-cost Amazon, Walmart, Shopify, and eBay listing, upload-preparation, advertising, and image-brief deliverables.","url":"https://friday-seller-tools-production.up.railway.app/v1/competitors/change-monitor-spec","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"after":{"type":"object","title":"CompetitorListingSnapshot","required":["captured_at"],"properties":{"title":{"anyOf":[{"type":"string","maxLength":500,"minLength":5},{"type":"null"}],"title":"Title","default":null},"rating":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"null"}],"title":"Rating","default":null},"bullets":{"type":"array","items":{"type":"string","maxLength":1000,"minLength":2},"title":"Bullets","maxItems":10},"price_usd":{"anyOf":[{"type":"number","maximum":1000000,"exclusiveMinimum":0},{"type":"null"}],"title":"Price Usd","default":null},"captured_at":{"type":"string","title":"Captured At","format":"date"},"description":{"anyOf":[{"type":"string","maxLength":5000,"minLength":10},{"type":"null"}],"title":"Description","default":null},"availability":{"anyOf":[{"enum":["in_stock","out_of_stock","limited","unknown"],"type":"string"},{"type":"null"}],"title":"Availability","default":null},"review_count":{"anyOf":[{"type":"integer","maximum":1000000000,"minimum":0},{"type":"null"}],"title":"Review Count","default":null}},"additionalProperties":false},"before":{"type":"object","title":"CompetitorListingSnapshot","required":["captured_at"],"properties":{"title":{"anyOf":[{"type":"string","maxLength":500,"minLength":5},{"type":"null"}],"title":"Title","default":null},"rating":{"anyOf":[{"type":"number","maximum":5,"minimum":0},{"type":"null"}],"title":"Rating","default":null},"bullets":{"type":"array","items":{"type":"string","maxLength":1000,"minLength":2},"title":"Bullets","maxItems":10},"price_usd":{"anyOf":[{"type":"number","maximum":1000000,"exclusiveMinimum":0},{"type":"null"}],"title":"Price Usd","default":null},"captured_at":{"type":"string","title":"Captured At","format":"date"},"description":{"anyOf":[{"type":"string","maxLength":5000,"minLength":10},{"type":"null"}],"title":"Description","default":null},"availability":{"anyOf":[{"enum":["in_stock","out_of_stock","limited","unknown"],"type":"string"},{"type":"null"}],"title":"Availability","default":null},"review_count":{"anyOf":[{"type":"integer","maximum":1000000000,"minimum":0},{"type":"null"}],"title":"Review Count","default":null}},"additionalProperties":false},"cadence":{"enum":["daily","weekly","monthly"],"type":"string","title":"Cadence","default":"weekly"},"marketplace":{"enum":["amazon_us","walmart_us","shopify","ebay_us"],"type":"string","title":"Marketplace","default":"amazon_us"},"watch_fields":{"type":"array","items":{"enum":["title","price_usd","bullets","description","availability","rating","review_count"],"type":"string"},"title":"Watch Fields","maxItems":7,"minItems":1},"competitor_label":{"type":"string","title":"Competitor Label","maxLength":100,"minLength":2},"listing_identifier":{"type":"string","title":"Listing Identifier","pattern":"^[A-Za-z0-9._:/-]+$","maxLength":120,"minLength":1}}},"responseSchema":{"type":"json","example":{"job_id":"example","status":"queued"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JuMGUl4L2N5t7SkZIQGaJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a specification/job for monitoring competitor product listing changes on e-commerce marketplaces like Amazon, Walmart, Shopify, and eBay.","exampleAgentPrompt":"Set up a competitor change monitor spec for my rival's Amazon ASIN B08XYZ1234 so I get alerted whenever they update their title, bullet points, price, or images.","exampleUseCases":[{"title":"Amazon rival price-drop alert","prompt":"Create a change monitor spec for competitor ASIN B09ABC5678 on Amazon — I want to know immediately if they drop their price or update their main listing image."},{"title":"Walmart competitor listing watch","prompt":"Set up a monitoring job on Friday Seller Tools to watch this Walmart product URL for any listing changes — title, description, or pricing — so I can react before they outrank me."},{"title":"eBay seller listing update tracker","prompt":"I need to track when my top eBay competitor updates their product listing for 'wireless earbuds XR200' — can you create a change monitor spec that flags title, bullet point, or category changes?"}],"resultDescription":"Returns a JSON object containing a job_id and a status field (e.g. 'queued'), confirming the change-monitor specification job has been accepted and queued for processing. The agent can use the job_id to poll for results or receive a completed monitoring spec.","failureModes":["Missing required competitor product identifier returns 400 validation error","Invalid marketplace identifier causes rejection","Payment failure (insufficient USDC) returns 402 Payment Required","Malformed URL or ASIN format returns validation error","Server overload may return 503 with retry guidance","Unsupported marketplace type may return 422 Unprocessable Entity"],"whenToPreferThis":"Choose this endpoint when you need to programmatically set up automated competitor listing surveillance on major marketplaces (Amazon, Walmart, Shopify, eBay) without manual monitoring. Prefer this over generic web-scraping solutions when you need marketplace-aware change detection tuned to listing fields like price, title, bullets, and images, and when you want a low-cost ($0.25/call) queued job approach rather than a synchronous scrape.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:19.718Z","isFirstParty":false}