SuggestAPISuggestAPIDocumentation
Contact usOpen app
Console

Import a Catalog

Load products into an index from files, a Google Shopping CSV, pasted JSON, or a one-click storefront crawl.

Copy page
Open in ChatGPTOpen with page contextOpen in ClaudeOpen with page context

Open the index, then Import. Use this tab to get documents into SuggestAPI. Watch progress on Tasks.

The public Merchant Center URL (https://feed.suggestapi.com/{domain}/) is a separate export. See Google Shopping feed export.

Before you import

  • Keep product IDs stable so later imports update the same records.
  • Include title, description, image URL, product URL, price, and brand when you have them. Those fields also feed search cards and the public shopping feed.
  • Finish or cancel any running task on this index. File upload, Shopping import, catalog crawl, export, and reindex cannot overlap.

Batches of about 1,000 documents or more, and large files, run as background tasks. Smaller JSON pastes can index immediately.

File upload

Drag a CSV, JSON, or JSONL file onto the drop zone, or browse. Prefer JSONL (one document per line) for large catalogs.

Confirm the upload. Large files may go to cloud storage first, then a background job. If another task is running, the drop zone stays disabled until that job finishes.

Paste JSON

Paste an array of documents and ingest. The payload must be a JSON array. Use this for a small fixture or a one-off correction, not a full catalog.

Google Shopping CSV import

Under Google Shopping feed, provide one of:

  • a public Google Shopping CSV feed URL, or
  • a CSV file export

Then Import feed.

The job maps Shopping columns into index documents. Partial success reports how many products indexed and how many failed. Track a queued import on Tasks.

This import fills the index. It does not by itself publish https://feed.suggestapi.com/{domain}/. That URL requires a verified domain and linked index.

To refresh later, run Import again. Scheduled Shopping sync is not in the live console nav.

1-Click Catalog Import

Queue a background crawl of a storefront or collection URL.

  1. Enter Catalog URL (for example https://store.example.com/collections/all). A collection path stays scoped to that collection.
  2. Set Max Pages (1–500; default 200).
  3. Optionally Force recrawl already-seen pages.
  4. Queue Catalog Import.

The crawler identifies itself as SuggestAPI Bot. Allow it in robots.txt if the site blocks unknown agents. Details: One Click Catalog Import.

Catalog import is blocked when another task is running, or when the workspace is at its document quota. Reduce Max Pages, delete unused documents, or upgrade.

After import

  1. Confirm the task completed on Tasks.
  2. Spot-check records on Documents.
  3. Add searchable fields and boosts on Configuration after you have representative data.
  4. Try queries on Test Search.