Ingest and query a product catalog with Constructor.io, including autocomplete and full-text search

Steps

1. Obtain your API token and key from the Constructor dashboard. Catalog items are ingested via the Catalog Management API; send a PATCH /v1/catalog request with a multipart body containing CSV or JSON files for items, variations, and item groups, plus a section parameter (typically 'Products').
2. For delta updates, set the type parameter to delta to update only changed records; for a full replacement use type=full. Constructor processes ingestion jobs asynchronously — poll the Tasks API (GET /v1/tasks/{task_id}) to confirm completion.
3. Query autocomplete suggestions by calling GET https://ac.cnstrc.com/autocomplete/{term}?key=YOUR_KEY&num_results=10&section=Products; the response contains suggestion groups including 'Search Suggestions' and 'Products'.
4. Query full-text search by calling GET https://ac.cnstrc.com/search/{term}?key=YOUR_KEY&page=1&num_results_per_page=20; apply filters via the filters[field]=value query parameter.
5. Send behavioral events (click, conversion, search) back to Constructor using the Events API (POST /v1/behavioral_action/click, etc.) with the user's session identifier so the model can personalise results over time.