Docs — Scrapit
Home Pricing About Docs Contact Add to Shopify →

Documentation

How to use Scrapit

Everything you need to know about installing, configuring, and getting the most out of Scrapit.

Last updated: April 2026

Installation

Scrapit is a native Shopify app — it lives directly inside your Shopify Admin. Installation takes about two minutes.

1

Find Scrapit on the Shopify App Store

Search for "Scrapit" in the Shopify App Store or open the listing directly. Click Add app.

2

Approve permissions

Scrapit requests permission to read and write your products and inventory. These are required for importing. No other data is accessed.

3

You're in

Scrapit opens inside your Shopify Admin under Apps → Scrapit. You'll see the main import screen immediately.

Data safety and permissions

  • Scrapit only requests the permissions needed for product and inventory import/sync workflows.
  • The app is focused on catalog operations inside your Shopify admin.
  • For policy details, see Privacy Policy and Terms of Service.

Your First Import

Importing your first product takes under a minute. Here's how:

1

Copy a product URL

Go to any Shopify-powered store, find a product you want to import, and copy the product page URL from your browser's address bar.

2

Paste it into Scrapit

Open Scrapit in your Shopify Admin and paste the URL into the input field. Scrapit will start fetching the product immediately.

3

Review and import

Scrapit shows you a preview of the product — title, description, images, variants, and price. Review, make any edits, then click Import to Shopify.

💡 Tip: Scrapit auto-detects when you copy a URL to your clipboard and can paste it automatically when you focus the input field.

Setting Up AI Scraping

AI scraping helps with difficult pages (JavaScript-heavy storefronts, unusual layouts, and inconsistent product markup) and supports both Google Gemini and OpenAI providers.

ℹ️ Connect your own API key in Settings → AI. You can choose Gemini or OpenAI and keep control of provider usage and billing.

Getting an API key

  • Gemini: Use aistudio.google.com to create a key.
  • OpenAI: Create a key from your OpenAI account dashboard.
  • Copy the key and store it securely.

Adding your key in Scrapit

  • Go to Settings → AI.
  • Select your active provider (Gemini or OpenAI).
  • Paste your key and click Save; Scrapit validates it immediately.

Once connected, you can use AI Scrap It options during imports. AI imports are available on the Pro plan.

Single Product Import

The single import flow is Scrapit's core feature. It handles one product URL at a time with a full preview before importing.

What gets imported

  • Title — cleaned and ready
  • Description — full HTML body
  • Images — all product images, in order
  • Variants — size, colour, and other options with their own prices
  • Price & compare-at price
  • Inventory quantity
  • Product type & tags — auto-mapped to Shopify's taxonomy

Re-importing an existing product

If a product from the same source URL already exists in your store, Scrapit detects it and offers a smart merge — updating changed fields while preserving your custom edits (like adjusted prices or custom variant names).

Bulk / Collection Import

Bulk import lets you scrape an entire category or collection page and import multiple products at once. Available on Free and Pro plans.

1

Paste a collection URL

Use the URL of a category or collection page (e.g. example.com/collections/shoes). Scrapit detects it's a listing page automatically.

2

Scrapit finds all products

Scrapit crawls the page and extracts all product URLs. You'll see a list of products with thumbnails and titles before importing.

3

Select and import

Choose which products to import (or select all), then click Bulk Import. Scrapit queues them and imports in the background.

⚠️ Note: Be mindful of the terms of service of the websites you scrape. Only import products you have the right to sell.

Advance Linking

Advance Linking helps you match imported source products with existing Shopify products. It is designed for merchants who want tighter control over re-linking and future updates.

How plan access works

  • Free: You can open the page, fetch products, and review suggestions.
  • Pro: Required to save new links using Re Linking.
  • Unlinking: Existing links can still be removed when sent in the request flow.

AI Scrap It

AI Scrap It improves difficult imports by generating cleaner product data and SEO content with AI.

Providers and setup

  • Scrapit supports Google Gemini and OpenAI.
  • Bring your own API key in Settings → AI.
  • You can configure defaults in Settings and override options per import session.

ℹ️ Plan note: AI import is a Pro feature. The setup UI is visible to all plans, but importing with AI requires Pro access.

Important behavior to know

  • AI imports are one-time imports — products created with AI Scrap It are not tracked for future sync by Scrapit.
  • No auto-sync lifecycle — they do not appear in the normal synced product pipeline unless later imported through regular import flows.
  • Same monthly import counter — successful AI imports count toward your monthly import usage.

Sync Engine

The Sync Engine keeps imported products up to date with source data, with different actions available by plan.

What gets synced

  • Price changes (with your markup rules applied)
  • Inventory quantities
  • New product images
  • Variant availability
  • Description updates

Plan access and frequency

  • Single-product sync: Available on Free and Pro.
  • Sync all products (bulk): Pro only.
  • Auto-sync interval options: 6, 12, 24, 48, or 72 hours in Settings → Sync.

💡 Scrapit uses smart diffing — it only updates fields that have actually changed, avoiding unnecessary Shopify API calls and preserving your manual edits.

Pricing Rules

Pricing rules let you automatically adjust prices when importing. Configure them in Settings → Pricing.

Available rules

  • Markup % — add a percentage margin on top of the source price
  • Markup fixed — add a fixed amount to every price
  • Price rounding — round to the nearest $0.99, $0.95, or full dollar
  • Compare-at price — auto-set the original price for showing a sale
  • Currency conversion — apply an exchange rate if the source is in a different currency

Import Settings

Control what gets imported by default. Found under Settings → Import.

  • Default product status — Draft or Active on import
  • Image import — toggle on/off, set max images per product
  • Auto-assign collection — add imported products to a specific collection
  • Tag prefix — add a custom tag like scrapit to all imported products for easy filtering

Inventory Settings

Control how Scrapit handles stock levels. Found under Settings → Inventory.

  • Default inventory policy — continue selling when out of stock, or deny
  • Set fixed quantity — override scraped inventory with a fixed value
  • Inventory location — choose which Shopify location receives the inventory
  • Track quantity — toggle whether Shopify tracks inventory for imported products

AI Settings

Manage provider keys and default AI feature behavior under Settings → AI.

  • Provider selection — choose Gemini or OpenAI as your active provider.
  • Bring your own API key — keys are validated when saved.
  • Default feature toggles — decide what AI generates by default (title, description, tags, SEO fields, and mapping features).
  • Per-import override — in AI Scrap It, you can temporarily override defaults for the current import session.

Advanced Settings

Use Settings → Advanced for fine-grained control over how re-import and sync preserve your custom changes.

  • Variant preservation rules — choose when Scrapit should keep your custom Shopify variants versus replacing from source data.
  • Re-import and sync behavior — configure separate rules so routine sync does not overwrite intentional manual edits.
  • Banner preferences — manage helper warnings so your team sees only the messages they still need.
  • Inventory maintenance tools — fix inventory/location mismatches when needed.

Import Limits

Scrapit uses monthly import limits that reset each calendar month (UTC):

  • Free: 15 imports or updates per month
  • Pro: 500 imports or updates per month (fair use)
  • The same monthly counter applies across Single Import, Bulk Import, and AI Scrap It imports.
  • Only successful new imports and real updates count; skipped no-change events do not increase usage.

Free vs Pro Matrix

Quick reference for the most important feature gates:

  • Single import: Free and Pro
  • Bulk/collection import: Free and Pro
  • AI Scrap It import action: Pro only (settings/setup visible on all plans)
  • Advance Linking save (Re Linking): Pro only (fetch/review UI still usable on Free)
  • Sync single product: Free and Pro
  • Sync all products (bulk): Pro only

Syncing Page

The Syncing page is your operational sync control center.

Main areas

  • Sync All card — run store-wide sync for tracked products (Pro only).
  • Sync Specific — search and sync individual products (all plans).
  • Sync Issues table — review products in error/paused states, then re-sync, remove from list, or delete from Shopify.

💡 If a product was manually removed from Shopify, Scrapit can clean up stale tracking rows so your sync list stays accurate.

Logs Page

The Logs page gives a read-only activity timeline across core workflows.

  • Import logs — import attempts and outcomes
  • Advance Linking logs — linking/unlinking batch actions
  • AI usage logs — AI feature calls and outcomes
  • Sync logs — sync attempts, status, and errors

ℹ️ Logs are for auditing and debugging. Monthly import limits are enforced from account counters, not by counting log rows.

Common Issues

URL points to the wrong flow

If you paste a collection URL in Single Import (or a product URL in Bulk), Scrapit can auto-route you to the correct tab.

AI import blocked on Free

AI setup is visible on all plans, but completing AI imports requires Pro. Upgrade on the Billing page to unlock AI import actions.

Advance Linking cannot save links

On Free, you can still fetch and review matching suggestions, but saving new links requires Pro.

Sync All unavailable

Bulk sync is Pro-only. Use single-product sync on Free, or upgrade to enable Sync All.

Quota reached

When your monthly import cap is reached, new import actions are blocked until reset. Limits reset monthly (UTC).

AI provider or rate limit errors

Re-check your API key in Settings → AI, verify provider billing/credits, then try again.

Need help from the team? Contact support and include your store domain plus a screenshot of the issue.

Best Practices

  • Start imports as Draft while testing new suppliers or categories.
  • Run a small batch first, review pricing and inventory results, then scale up.
  • Set pricing rules before bulk imports so product prices are consistent from day one.
  • Use Advance Linking for products that need long-term source-to-store mapping control.
  • Check Sync Issues and Logs weekly to catch supplier or mapping changes early.

FAQ

Why did my import fail?

Most failures come from invalid URLs, temporary source-store issues, quota limits, or AI provider key/credit problems. Re-check the URL and plan gates first, then review Logs.

Why is Sync All disabled?

Sync All is a Pro feature. Free plans can still run single-product sync from Syncing pages.

Why can I open AI Scrap It but cannot import?

AI settings and UI are visible on all plans, but the AI import action itself is Pro-only.

Does AI Scrap It create synced products?

No. AI Scrap It is a one-time import flow and does not create the regular tracked sync lifecycle by itself.

Do logs affect my monthly import quota?

No. Logs are for auditing and troubleshooting. Monthly limits are tracked from account counters.

Need Help Fast

For quickest support, use the Contact page and include:

  • Your Shopify store domain
  • The exact source URL you used
  • A screenshot (or short screen recording) of the error
  • Whether this happened in Single, Bulk, AI Scrap It, Advance Linking, or Syncing

Reviews & Feedback

Scrapit may show a short in-app prompt after successful usage milestones.

  • Happy with results: you can leave an App Store review directly.
  • Not satisfied yet: send quick feedback so the team can improve the product.
  • Dismissed prompt: it stays hidden for the rest of the current month.