Seiko Watch Scraper (USA)

Scrape Seiko USA watch and clock listings from seikousa.com — the official US storefront. Browse by collection (Prospex, Presage, Astron, Seiko 5 Sports, Coutura), fetch individual products by handle, or keyword-search across the full catalog. Returns model numbers, prices, images, case specs, and availability. Free Shopify JSON API — no proxy, no auth required.

What this actor does

• Four modes: byCollection (default), allProducts, byHandle, search
• Collection filtering: Prospex, Presage, Astron, Seiko 5 Sports, Coutura, Best Sellers, Clocks, Accessories
• Rich metadata: extracted from Shopify product tags — collection, case diameter, gender, price bracket
• Availability flag: whether the product is currently in stock
• Empty fields are omitted — no nulls in output

Output per watch record

Field	Description
productId	Seiko/Shopify product ID
handle	URL-safe product slug (e.g. ssc947)
title	Product title — usually the model number
modelNumber	Watch model number (same as title for Seiko products)
vendor	Vendor (Seiko, Seiko Clocks, etc.)
productType	Product type (Wrist Watches, Clock, Accessories)
collection	Seiko collection (Prospex, Presage, Astron, etc.)
description	Product description (up to 500 chars, HTML stripped)
price	Retail price (USD float)
priceCurrency	Always USD
compareAtPrice	Original MSRP if on sale
available	Whether currently in stock
caseDiameter	Case diameter range (e.g. 40.0-42.9mm)
gender	Target gender (Men / Women / Unisex)
sku	Stock-keeping unit (if different from model number)
tags	All product tags from Shopify
imageUrl	Primary product image URL (Shopify CDN)
imageCount	Total number of product images
additionalImages	Up to 2 additional image URLs
publishedAt	Date the listing was published
listingUrl	Direct URL on seikousa.com
recordType	Always watch
sourceUrl	API URL used to fetch data
scrapedAt	ISO 8601 timestamp

Input

Field	Type	Default	Description
mode	string	byCollection	byCollection / allProducts / byHandle / search
collection	string	prospex	Collection to scrape (mode=byCollection)
handle	string	–	Product handle (mode=byHandle), e.g. ssc947
searchQuery	string	diver	Keyword filter against title, tags, collection, description (mode=search)
maxItems	integer	50	Maximum records to emit (1–500)

Example: scrape all Prospex dive watches

{
  "mode": "byCollection",
  "collection": "prospex",
  "maxItems": 100
}

Example: fetch a single watch by handle

{
  "mode": "byHandle",
  "handle": "ssc947"
}

Example: search for all solar watches

{
  "mode": "search",
  "searchQuery": "solar",
  "maxItems": 50
}

Example: get full Seiko USA catalog

{
  "mode": "allProducts",
  "maxItems": 500
}

Available collections

Value	Description
prospex	Prospex — dive and sport watches
presage	Presage — dress and mechanical watches
astron	Astron — GPS solar watches
seiko5sports	Seiko 5 Sports — automatic watches
coutura	Coutura — luxury dress watches
best-sellers	Best Sellers collection
clocks	Seiko wall and desk clocks
accessories	Watch straps and accessories
all	All products across all collections

Use cases

• Watch research — compare Seiko models, specs, and prices across collections
• Price monitoring — track price changes and sale events on the official US store
• Inventory tracking — monitor which models are in stock or sold out
• E-commerce intelligence — analyze Seiko's product catalog structure
• Gift ideas — find watches by price bracket, gender, and collection
• Market data — compile watch model databases for valuation tools

FAQ

What is Seiko USA? Seiko USA (seikousa.com) is the official US online store for Seiko watches and clocks. It runs on Shopify, which exposes a public JSON API (/products.json, /collections/{handle}/products.json) for catalog data.

Do I need an API key or proxy? No. The Seiko USA Shopify JSON API is publicly accessible without authentication. No proxy is required.

What are Seiko collections? Seiko organizes their watches into branded lines — Prospex (sport/dive), Presage (dress/mechanical), Astron (GPS solar), Seiko 5 Sports (affordable automatic), and Coutura (luxury dress). Each is a distinct collection with its own design language.

What's the handle field? The handle is the URL slug for a product, used in the listing URL: https://www.seikousa.com/products/{handle}. Use it in mode=byHandle to fetch a specific watch.

How fresh is the data? The Shopify API reflects the live product catalog. Prices, availability, and product listings are updated in real time on the Seiko USA store.

Why are some fields absent from certain records? Seiko's product tags drive collection, gender, and case diameter extraction. If a product lacks the relevant tags, those fields are omitted. Description is truncated at 500 characters.