# Allegro Seller Leads Scraper (`axlymxp/allegro-seller-leads-scraper`) Actor

Turn Allegro.pl sellers into B2B leads — get each seller's registered company name, NIP/EU-VAT tax id, city, ratings and super-seller status from any keyword or category. Deduped, one clean row per seller, ready for your CRM or outreach. Pay only for the leads you get.

- **URL**: https://apify.com/axlymxp/allegro-seller-leads-scraper.md
- **Developed by:** [axly](https://apify.com/axlymxp) (community)
- **Categories:** Lead generation, E-commerce
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $15.00 / 1,000 dataset items

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/actors/running/actors-in-store.md#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

## Allegro Seller Leads Scraper

Generate **B2B lead lists from [Allegro.pl](https://allegro.pl)** — Poland's largest
online marketplace. Give a keyword or category and get, for every **unique**
seller, their registered **company name, NIP / EU-VAT tax id, city, ratings and
super-seller status** — the business identity that ordinary listing scrapers never
expose. Deduped, one clean row per seller, ready for your CRM or outreach.

No login, OAuth or proxy setup — Allegro's DataDome anti-bot is handled for you.
Output is clean JSON/CSV/Excel.

### Who it's for

- **B2B sales & lead-gen agencies** — build prospect lists of active Allegro
  merchants in any niche, complete with company name and tax id.
- **Brands & distributors** — discover who resells your products and capture the
  registered company + NIP for channel management and MAP enforcement.
- **Market & competitive researchers** — map the seller landscape of a category:
  how many businesses compete, where they are based, how they're rated.
- **Data & RevOps teams** — enrich a CRM with verified company identifiers (NIP is
  a unique Polish business registration number, ideal for matching).

### What you get (output fields)

| Field | Type | Description |
|---|---|---|
| `seller_login` | string | Allegro seller username |
| `seller_name` | string | Seller display name |
| `super_seller` | boolean | Allegro "Super Sprzedawca" status |
| `company_name` | string | Registered company / trading name |
| `tax_id` | string | **NIP / EU-VAT tax identification number** |
| `vat_country` | string | Country from the VAT id (e.g. PL, SK) |
| `company_city` | string | Registered company city |
| `seller_ratings` | object | Seller rating summary |
| `seller_id` | string | Allegro seller id |
| `sample_offer_id` | string | An offer this seller was found through |
| `sample_offer_title` | string | Sample offer title |
| `sample_offer_url` | string | Sample offer URL |
| `sample_offer_price` | string | Sample offer price |
| `sample_offer_currency` | string | Currency (PLN) |
| `sample_offer_rating` | number | Sample product rating |
| `category_id` | string | Category the seller was mined from |
| `source_type` / `source_value` | string | Query/category that produced the lead |
| `scraped_at` | string | ISO-8601 timestamp |

By default only **business sellers** (those exposing a company / NIP) are returned;
set `businessOnly` to `false` to include private individuals too.

### High-value use cases

1. **Niche prospect lists** — search "drukarki 3D" or a category and export every
   business seller with company + NIP for outbound sales.
2. **Reseller / grey-market detection** — find all merchants selling your brand and
   identify the legal entity behind each shop.
3. **Market entry research** — quantify and locate the competing businesses in a
   category before launching in Poland.
4. **CRM enrichment** — match Allegro shops to registered companies via NIP and
   append city + ratings.

### Input parameters

| Field | Type | Default | Description |
|---|---|---|---|
| `searchQueries` | array | `["drukarka laserowa"]` | Keywords whose sellers you want |
| `categoryUrls` | array | `[]` | Category pages/slugs to mine for sellers |
| `businessOnly` | boolean | `true` | Only sellers with a company / NIP |
| `condition` | enum | `any` | `any`, `new`, `used` |
| `minPrice` / `maxPrice` | integer | — | Restrict discovery to a price band (PLN) |
| `includeSponsored` | boolean | `true` | Also mine sponsored offers |
| `maxSellers` | integer | `100` | Stop after this many unique leads |
| `maxOffersScanned` | integer | ~15× `maxSellers` | Safety cap on offers scanned |

At least one of `searchQueries` or `categoryUrls` is required.

#### Example input

```json
{
    "searchQueries": ["drukarka laserowa", "toner"],
    "businessOnly": true,
    "minPrice": 100,
    "maxSellers": 200
}
```

#### Example output row

```json
{
    "seller_login": "komtek",
    "seller_name": "komtek",
    "super_seller": true,
    "company_name": "KOMTEK KONRAD WAJDA",
    "tax_id": "677-172-96-99",
    "vat_country": "PL",
    "company_city": "Kraków",
    "sample_offer_url": "https://allegro.pl/oferta/18567803358",
    "sample_offer_price": "554.00",
    "sample_offer_currency": "PLN",
    "category_id": "260089",
    "scraped_at": "2026-08-28T10:00:00+00:00"
}
```

### Scheduling & integrations

- **Schedule** weekly runs to keep a fresh prospect list per category.
- **Webhooks** push new leads to your CRM, Make or Zapier on completion.
- **Export** to JSON, CSV or Excel, or pull the Apify **dataset API** into Google
  Sheets, HubSpot, Pipedrive, BigQuery or S3.

### Use from an AI agent (MCP)

Callable from AI assistants via the Apify MCP server, so an LLM agent can build a
lead list from Allegro on demand. Point your MCP client at `https://mcp.apify.com`
and call `allegro-seller-leads-scraper`.

### FAQ

**Where does the company / NIP come from?** Each seller's own offer detail page on
Allegro publicly shows the registered business data for VAT-registered merchants;
the Actor reads it once per seller and dedupes.

**Do I need a proxy or Allegro account?** No. DataDome anti-bot and location are
handled automatically.

**Why are some sellers missing?** Private individuals don't publish a company/NIP;
with `businessOnly` on (default) they're skipped. Turn it off to include them.

**How many leads can I get?** Bounded by `maxSellers` and how many unique sellers a
query surfaces. Use several keywords or categories to widen the net.

**Is this legal / GDPR-safe?** The Actor collects only publicly listed business
data. NIP/company data of sole traders can be personal data under GDPR — you are
responsible for a lawful basis (e.g. legitimate interest) when using it for
outreach, and for honoring opt-outs.

# Actor input Schema

## `searchQueries` (type: `array`):

Keywords whose sellers you want as leads, e.g. 'drukarka laserowa', 'fotel biurowy'. One search is run per keyword.

## `categoryUrls` (type: `array`):

Optional. Allegro category pages to mine for sellers — a full URL (https://allegro.pl/kategoria/laptopy-491) or a bare slug (laptopy-491).

## `businessOnly` (type: `boolean`):

Only return sellers that expose a registered company / NIP-VAT tax id (skip private individuals). Recommended for B2B lead generation.

## `condition` (type: `string`):

Restrict discovery to offers of this condition.

## `minPrice` (type: `integer`):

Optional. Only mine offers at or above this price (targets higher-value sellers).

## `maxPrice` (type: `integer`):

Optional maximum offer price in PLN.

## `includeSponsored` (type: `boolean`):

Also mine sellers from sponsored/promoted offers.

## `maxSellers` (type: `integer`):

Stop after collecting this many unique seller leads.

## `maxOffersScanned` (type: `integer`):

Safety cap on how many listing offers to scan while looking for new sellers. Defaults to ~15× Max seller leads.

## Actor input object example

```json
{
  "searchQueries": [
    "drukarka laserowa"
  ],
  "categoryUrls": [],
  "businessOnly": true,
  "condition": "any",
  "includeSponsored": true,
  "maxSellers": 100
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 = {
    "searchQueries": [
        "drukarka laserowa"
    ],
    "categoryUrls": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("axlymxp/allegro-seller-leads-scraper").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 = {
    "searchQueries": ["drukarka laserowa"],
    "categoryUrls": [],
}

# Run the Actor and wait for it to finish
run = client.actor("axlymxp/allegro-seller-leads-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "drukarka laserowa"
  ],
  "categoryUrls": []
}' |
apify call axlymxp/allegro-seller-leads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axlymxp/allegro-seller-leads-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8JJaewohTsO1ySKjV/builds/UdP7lfnwxCw4Gc7ey/openapi.json