# Zid Store Products Scraper (`zinin/zid-store-products`) Actor

Pull live product catalogs (name, price, sale price, category, image) straight from Zid storefronts — a common Saudi/Gulf e-commerce SaaS — via their own public JSON feed. No login, no browser, no proxies.

- **URL**: https://apify.com/zinin/zid-store-products.md
- **Developed by:** [Tim Zinin](https://apify.com/zinin) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Zid Store Products — Saudi/Gulf E-commerce Catalog Scraper

Zid is a widely used e-commerce SaaS platform across Saudi Arabia and the Gulf — the region's counterpart to Shopify — with storefronts built and sold in Arabic. This Actor pulls a live product catalog straight from any Zid storefront's own public JSON feed and returns one row per product: name, price, sale price, category, image and a direct link — no browser, no proxies, no login, no Zid API key.

### What you get

- **Live catalog, not a stale export.** The same feed the storefront itself uses to render its catalog — name, price, sale price, category, image and direct product URL for every item.
- **Honest about partial scans.** Every row carries `catalogComplete`, and when a scan stops before the true end of the catalog — a page erroring out mid-pagination, or the shop simply having more products than the scan cap — `catalogTruncatedReason` says why. A shorter result never gets passed off as a fully-scanned small shop.
- **Any Zid storefront.** Pass a shop's subdomain or its full `*.zid.store` host — works even for shops running a custom domain, since the `*.zid.store` host usually stays reachable.
- **No login, no proxies, no browser, no Zid API key.** One keyless GET per page of the store's own public `/api/v1/products` feed.
- Runs on Apify: schedule it, monitor it, call it from the API or the MCP server, export to JSON, CSV or Excel, or push results straight into your own pipeline.

### How to run it

1. Click **Try for free** — no card needed on the free plan.
2. Paste Zid shop subdomains into **Zid shop subdomains**, one per line — e.g. `furniture` (or the full host, `furniture.zid.store`).
3. Press **Start**. Results appear in the dataset — read them in the UI, pull them from the API, or have a webhook push them onward.

### Pricing

Pay-per-event: **$0.005 per run start + $0.003 per product found**. No monthly seat, no minimum. 100 products cost about **$0.31**; 1,000 products about **$3.01**.

A shop that's unreachable or not a live Zid storefront is still logged with `found: false` and the reason — and it is **not** charged for. You pay for products actually delivered, not for attempts.

### Input

| Field | Required | What it does |
|---|---|---|
| `items` | yes | One entry per Zid storefront: shop subdomain (e.g. `furniture`) or full host (`furniture.zid.store`). Up to 20 per run. |
| `maxConcurrency` | no | How many shops to scan in parallel, 1–20 (default 5). |

```json
{
    "items": [
        "furniture",
        "scent"
    ]
}
```

### Output

One dataset row per product found, paginating up to 5 pages per shop. This is a real row from a real run:

```json
{
    "input": "furniture",
    "found": true,
    "productId": "e82d8d8f-717e-4ad0-8f3f-485bf83ddd24",
    "name": "طقم فانوسين بتصميم lndustry",
    "price": 94,
    "currency": "SAR",
    "salePrice": null,
    "url": "https://furniture.zid.store/products/bx1kqE9WLD",
    "image": "https://media.zid.store/thumbs/b2833a09-186e-4e5a-9aef-75c01d6c006c/3620ba17-d853-4e52-984b-99b0312eb2aa-thumbnail-1000x1000-70.jpeg",
    "category": "اثاث داخلي واكسسوارات",
    "catalogComplete": true,
    "catalogTruncatedReason": null,
    "scrapedAt": "2026-07-26T13:24:25.268Z"
}
```

| Field | What it means |
|---|---|
| `input` | The shop subdomain you passed |
| `found` | Whether the shop returned at least one product |
| `productId` | Zid's internal product ID |
| `name` | Product name, in Arabic as listed |
| `price` / `salePrice` | Numeric price and sale price (null if not on sale) |
| `currency` | ISO currency code (typically SAR) |
| `url` | Direct product page URL |
| `image` | Product image URL |
| `category` | First listed category name |
| `catalogComplete` | `true` once every page of the shop's catalog was seen; `false` when the scan stopped early |
| `catalogTruncatedReason` | Why the scan stopped early, when `catalogComplete` is `false` — a failed page, an unexpected response shape, or the 5-page scan cap |
| `scrapedAt` | When this Actor fetched the row |

#### Need the rest of the picture?

These run on the same account, take the same shape of input and bill the same way, so they slot into an existing pipeline without new plumbing.

| Actor | What it does |
|---|---|
| [Chotot Vietnam Listings Scraper](https://apify.com/zinin/chotot-listings) | Pull live classified ad listings (real estate, vehicles, electronics, jobs and more) straight from… |
| [Shopify Store Intelligence](https://apify.com/zinin/shopify-store-intelligence) | Confirm a site runs on Shopify and pull store intelligence from its public feeds — product count, price… |
| [AI Answer Change Alert](https://apify.com/zinin/ai-answer-change-alert) | Track whether an AI assistant's answer to a query you care about changed since last time — new sources… |
| [AI Crawler Access Checker](https://apify.com/zinin/ai-crawler-access-checker) | Check which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended & more) can access your website |
| [AI Overview Citation Tracker](https://apify.com/zinin/ai-overview-tracker) | For each query that matters, see which sources and domains AI assistants cite in their answer — grounded… |

### FAQ

**Does it need an API key / login?** No — every Zid storefront's product feed is public by default.

**How fresh is the data?** Live at request time — the same feed the storefront itself uses to render its catalog.

**What happens if a shop has more products than the scan covers?** You still get every product the scan reached, but `catalogComplete` is `false` and `catalogTruncatedReason` says why — a partial catalog is never silently presented as the whole thing.

**Can I call it from an AI agent?** Yes — standard Apify Actor, callable from the Apify API, the SDK, or the Apify MCP server.

**What this is NOT.** It does not translate Arabic product listings, does not extract customer reviews, and scans up to 5 pages per shop — a live catalog sample, not an unlimited crawl.

Found a wrong result, or need a check we don't run? Open an issue on this Actor's page.

***

Built by [zinin](https://apify.com/zinin). Questions? Telegram [@timzinin](https://t.me/timzinin).

# Actor input Schema

## `items` (type: `array`):

One entry per Zid storefront — the shop's subdomain (e.g. `furniture`) or full host (`furniture.zid.store`). Find the subdomain in the store's own zid.store URL, or via its custom domain's storefront (Zid stores usually keep the \*.zid.store host reachable even with a custom domain attached).

## `maxConcurrency` (type: `integer`):

How many shops to scan in parallel.

## Actor input object example

```json
{
  "items": [
    "furniture",
    "scent"
  ],
  "maxConcurrency": 5
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "items": [
        "furniture",
        "scent"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zinin/zid-store-products").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "items": [
        "furniture",
        "scent",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("zinin/zid-store-products").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "items": [
    "furniture",
    "scent"
  ]
}' |
apify call zinin/zid-store-products --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zinin/zid-store-products",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/Ze7DESSISC0zOhpT9/builds/Md8uvoKL9kOIabofT/openapi.json