Documentation The backend currently supports several import and sync paths suited to catalog-heavy systems.
Supported patterns in the codebase
- Google Shopping feed import via
/v1/indexes/{index_id}/import/google-shopping - generic file upload ingestion via
/v1/indexes/{index_id}/upload - catalog scrape jobs via
/v1/indexes/{index_id}/catalog-scrape - webhook ingestion helpers for Shopify, WooCommerce, and HubSpot-oriented flows
Best-fit use cases
- use Google Shopping import when your source catalog already exists as a feed
- use file upload when you need quick bulk loads from CSV, JSON, or JSONL
- use webhook flows when you want near real-time product or content updates
Data shape guidance
For best downstream rendering, make sure your source payloads include:
- stable product IDs
- human-friendly titles
- useful descriptions
- image URLs
- canonical product URLs
- price, currency, brand, and category where available