Scan Watched Store
POST
Manual "scan now" (de-dup-guarded).
HTTPBearerheader
AuthorizationBearer <token>watched_store_id*Watched Store IdFormat
uuidSuccessful Response
application/json- response
A watched store as seen by ONE subscriber. Store status is global; the
subscription fields are the viewer's own. Deliberately carries NO precise
scan timestamps (next_scan_at / precise last_scan_at) — those would
leak a co-watcher's cadence (CONCEPT §9 F8.1).
id*IdFormat
uuidurl*Urlname?string|nullstatus*WatchedStoreStatusScan-health status of a watched store (a display badge only — products
stay visible regardless of status). Stored as plain text (no Postgres ENUM,
like RevisionActorType) so a new value is zero-DDL. pending is the
pre-first-scan state; unreachable = DNS/timeout/conn error; invalid
= reachable but not a public Shopify store (password page / 401/403 / not
Shopify JSON).
Value in
"pending""active""unreachable""invalid"status_detail?string|nullproduct_count*Product Countinitial_crawl_completed*Initial Crawl Completedlistings_last_7_days*Listings Last 7 DaysRange
0 <= valuelistings_last_30_days*Listings Last 30 DaysRange
0 <= valuelisting_activity_12m*array<>traffic_country?string|nullsearch_traffic_12m?array<integer|null>screenshot_url?string|nulltracking_pixels?|nullpaused*Pausedscan_interval_minutes?integer|nullsubscribed_at*Subscribed AtFormat
date-timetags?array<string>curl -X POST 'https://app.copyhero.app/api/v1/watchlist/stores/497f6eca-6276-4993-bfeb-53cbbbba6f08/scan'Example Response
{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "url": "string", "name": "string", "status": "pending", "status_detail": "string", "product_count": 0, "initial_crawl_completed": true, "listings_last_7_days": 0, "listings_last_30_days": 0, "listing_activity_12m": [ { "month": "2019-08-24", "count": 0 } ], "traffic_country": "string", "search_traffic_12m": [ 0 ], "screenshot_url": "string", "tracking_pixels": { "property1": [ "string" ], "property2": [ "string" ] }, "paused": true, "scan_interval_minutes": 0, "subscribed_at": "2019-08-24T14:15:22Z", "tags": [ "string" ]}