Developer API

The Synclyst API turns product photos into listing-ready data. Every scan feeds our anonymised market intelligence dataset — after enough similar items, responses include real sold-price signals, not just AI guesses.

Authentication

Developer keys use the sk_live_ prefix. Never expose keys in client-side browser code — call the API from your server or Zapier.

Base URL

https://synclyst-api-wx527b7eoq-uc.a.run.app — also available at /api/v1/public/*

Endpoints

POST /v1/extract

Full product extraction. Body: image_base64 or image_url, mime_type, optional use_case (reseller, real_estate, insurance, pawnbroker, invoice, restaurant, generic).

curl -X POST https://synclyst-api-wx527b7eoq-uc.a.run.app/v1/extract \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/product.jpg","use_case":"reseller"}'

Response includes scan_id, extraction fields, and market_intelligence.

POST /v1/classify

Category, brand, and condition only (skips web enrichment). Cheaper per call.

POST /v1/value

Price estimate from sold data when available; AI fallback otherwise.

GET /v1/market-value

Query: category, brand, optional condition, platform.

GET /v1/trending

Categories with rising scan volume vs the prior period.

PATCH /v1/scan/{scan_id}/outcome

Report listing outcome to improve market intelligence.

Rate limits

• 60 requests per minute per API key (burst)
• Monthly quota by plan (see dashboard)
• HTTP 429 when exceeded

Pricing (API plans)

Upgrade in the dashboard. Per-call metered rates by use_case from £0.05–£0.25.

Legacy routes

POST /api/v1/vision/extract remains for the web app. New integrations should use /v1/extract.