Developer API

Add FindWatch to your own app or agent: identify a watch from a photo, search live dealer prices for an exact reference, and place a watch in a scene. Simple REST calls with an API key, paid per call from prepaid API credits (1 API credit = $0.01).

Get started

Create a FindWatch account, or sign in.
Buy API credits on this page (packs from $10).
Create an API key and send it in the x-api-key header.

Create an account Sign in

API Reference

REST endpoints. All requests require an x-api-key header.

Identify a watch

POST /identify — "mode": "enhanced" (default, 5 credits: photo comparison with catalog photos and a deeper check when needed) or "mode": "fast" (2 credits: first pass only). Send the photo as imageUrl (a public https:// link) or imageData (a data:image URL). Charged on success only.

curl -X POST https://bfxhjcvrqdhzguvcswko.supabase.co/functions/v1/api-gateway/identify \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"imageUrl":"https://example.com/watch.jpg","mode":"enhanced"}' \
  --max-time 180

Search prices

POST /prices — 12 credits (standard, or "scope": "country"), 14 with "scope": "eu" (EU buyers: the EU market; elsewhere it runs and is charged as a country search), 22 with "scope": "worldwide". Set the buyer's country with "country" (ISO code, e.g. "DE"; default US). Refunded if it fails.

curl -X POST https://bfxhjcvrqdhzguvcswko.supabase.co/functions/v1/api-gateway/prices \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"query":"TAG Heuer Carrera CBS221M"}' \
  --max-time 120

# brand / model / reference also works:
#   -d '{"brand":"TAG Heuer","model":"Carrera","reference":"CBS221M"}'
# a search area and the buyer's country:
#   -d '{"query":"TAG Heuer Carrera CBS221M","scope":"worldwide","country":"GB"}'

Visualize a watch

POST /visualize — 25 credits; Combine XL (multi-image) 50 credits; "useProEngine": true (prioritize the scene) 35 credits. Refunded if it fails.

curl -X POST https://bfxhjcvrqdhzguvcswko.supabase.co/functions/v1/api-gateway/visualize \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"imageBase64":"data:image/jpeg;base64,...","brand":"TAG Heuer","model":"Carrera","scene":"beach"}' \
  --max-time 300

All endpoints run live AI and web research in the background. Use 3 minutes for identification, 2 minutes for price search, and 5 minutes for visualize.

Price per call

In API credits (1 API credit = $0.01).

Identification, Enhanced (default)charged on success only5$0.05
Identification, Fastcharged on success only2$0.02
Live price search (standard or one country)refunded if it fails12$0.12
Live price search, EU marketfor EU buyers; refunded if it fails14$0.14
Live price search, worldwiderefunded if it fails22$0.22
Visualizationrefunded if it fails25$0.25
Visualization, prioritize the scenerefunded if it fails35$0.35
Combine XL (several photos)refunded if it fails50$0.50

API credit packs

Separate from website credits. Sign in to buy.

1,000 API credits

$10

5,000 API credits

$50

25,000 API credits

$250