How to Import Your Product Feed

Choose Your Import Method

EcomIQX supports five ways to get your products into the platform. Pick the method that matches how you currently manage products.

Method 1: XML Feed Import

Best if: You have a product feed (Google Shopping feed, custom XML, data feed from supplier).

Steps

1. Go to Settings → Connectors → Add Feed.
2. Select "XML Feed".
3. Paste your feed URL (must be publicly accessible and updated regularly).
4. Click "Test Connection" to validate the feed structure.
5. Confirm the field mapping (title, description, price, brand, GTIN, images, URL, availability).
6. Click "Connect". EcomIQX imports your products in the background.

Sync Frequency

XML feeds are not synced on a schedule. To pick up changes, re-import the feed manually after you update it. Store connectors (Shopify, WooCommerce) can sync automatically when auto-sync is enabled; see Methods 3 and 4.

Required Fields

Minimum viable product: title, description, price, URL. Optional but recommended: brand, GTIN, images, availability, category.

Method 2: CSV Upload

Best if: Products are in a spreadsheet, custom database, or no live feed exists yet.

Steps

1. Export your products as CSV. Columns: title, description, price, brand, GTIN, image_url, product_url, availability.
2. Go to Settings → Connectors → Add Feed.
3. Select "CSV Upload".
4. Upload your file (max 100MB, 100,000 rows per file).
5. Map columns: confirm which column is title, which is description, etc.
6. Click "Import". Products are added in the background.

Recurring CSV Imports

If you export products weekly, set up a recurring import schedule. EcomIQX will replace existing products on schedule (matching by URL or GTIN).

Method 3: Shopify Integration

Best if: You run Shopify as your primary store.

Steps

1. Go to Settings → Connectors → Add Connector.
2. Select "Shopify".
3. Enter your Shopify store URL (e.g., yourstore.myshopify.com).
4. Click "Authorize". You will be taken to Shopify to approve the integration.
5. Grant permission to read products and product data.
6. Return to EcomIQX. Import begins automatically.

What Gets Imported

Title, description, price, variants, images, collections, tags, inventory, and handle (URL slug).

Sync Frequency

When auto-sync is enabled for a connector, a scheduler checks every few minutes which connectors are due, and each connector syncs at its own interval. You can also sync manually at any time. Synced changes include new products, price changes, description edits, and inventory updates.

Limitations

Free plan imports and scores up to 25,000 products. Upgrade to Pro ($99/month) for more credits per month and no import cap, or Business ($299/month) for more agents and API access.

Method 4: WooCommerce Integration

Best if: You run WooCommerce on WordPress.

Steps

1. In EcomIQX, open the integrations settings and choose WooCommerce.
2. Enter your store address (it must use https).
3. WooCommerce asks you to approve read and write access. Approve it; WooCommerce creates the API keys for EcomIQX. No plugin is needed.
4. Import begins automatically.

What Gets Imported

Title, description (or short description), price, SKU, images, the first category, brand where your store has one, stock status, and each variation with its attributes, price and SKU.

Sync Frequency

When auto-sync is enabled for the connector, it syncs on its own interval, and you can sync manually at any time.

Limitations

Free plan: import up to 25,000 products with 30 credits/month. Upgrade to Pro for 1500 credits/month.

Method 5: Feed URL Plus the REST API

Best if: You have a custom system and want to automate the round trip.

The REST API (Business and up) does not create products: products come in through a feed (Methods 1 and 2) or a store connector. Point EcomIQX at a feed URL your system keeps current, then use the API to work on the catalog EcomIQX holds.

Setup

1. Go to Settings → API Keys and create a key for your application.
2. Store the key securely (never commit it to version control).

What the API Does

• Read products with their scores, keywords and change history
• Update a product's title and description
• Request rewrites, then approve, reject, publish or roll them back
• Request, approve and publish translations
• Read keywords and start keyword research
• List feed imports, run an import again and download supplemental feeds
• Read catalog health, score and attribution summaries
• List automations, start a run and read past runs
• List the content changes published since a date
• Download the OpenAPI description of every endpoint

Example: Import a Feed Again After It Changes

curl -X POST https://app.ecomiqx.com/api/v1/feeds/FEED_ID/reimport \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

The full reference, with request and response schemas, is at API documentation.

After Import: What Happens Next

Once products are imported, EcomIQX automatically:

1. Analyzes content: Scores title, description, keyword coverage, readability, conversion copy, GEO, images, and structured data.
2. Runs enrichment: Fetches product images from your URLs, validates URLs are live, checks for existing schema.org markup.
3. Extracts keywords: If you have GSC connected, matches your products to search queries. Otherwise, extracts inferred keywords from content.
4. Generates initial recommendations: Flags low-scoring products and suggests rewrite priorities.

Full analysis time depends on catalog size.

Troubleshooting

Products did not import

Check: (1) Feed/file is publicly accessible or properly formatted (2) No duplicate external IDs (3) Required fields are present (title and description minimum).

Sync is not updating

For XML feeds: Check feed URL still works. For Shopify/WooCommerce: Verify the integration has not been revoked in your store settings. For API: Verify API key is correct and requests are returning 200 status.

Import is slow

Very large imports take longer. Use the batch API for better control on very large catalogs.