# eBay Email Scraper (`leads-scraper/ebay-email-scraper`) Actor

eBay Email Scraper SD - eBay Email Scraper is a lead generation tool that extracts leads with public contact emails, account names and profile URLs from eBay results by keyword, location and email domain - eBay email extractor.

- **URL**: https://apify.com/leads-scraper/ebay-email-scraper.md
- **Developed by:** [Leads Scraper](https://apify.com/leads-scraper) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### eBay Email Scraper - public seller and store emails from eBay

The **eBay Email Scraper** turns publicly indexed eBay pages into a deduplicated list of business contact emails.
It is built for wholesale buyers, liquidation and surplus traders, marketplace agencies, brand-protection teams and dropshippers who need to reach the operator behind a seller profile or an eBay Store.
Give it keywords, optional email domains and a location, and it hands back a structured dataset ready for CSV, JSON or Excel export.

eBay is one of the two strongest performers in this Actor family.
It exposes accounts on clean path handles - `/usr/` for seller profiles and `/str/` for eBay Stores - and the eBay Email Scraper resolves both, normalising each to a canonical `https://www.ebay.com/usr/{username}` profile URL.
In a recent live test every row returned came back with account identity **and** a usable profile URL.

The eBay Email Scraper does not log in, does not use eBay's API and never opens ebay.com itself.
Every lead comes from Google's public index - titles, snippets and site labels - fetched through the Apify GOOGLE\_SERP proxy.
There is no browser, no JavaScript rendering, no authentication and no cookies.

#### What the eBay Email Scraper does

The eBay Email Scraper composes Google queries with the `site:` operator against eBay's domains and reads the result blocks that come back.
A generated query looks like `site:ebay.co.uk store seller wholesale "@gmail.com" "Manchester"`.
Each block is parsed structurally, emails are pulled with a domain-filtered regex, and every unique address is pushed straight to the Apify dataset.

This config covers **ebay.com, ebay.co.uk, ebay.de and ebay.com.au**, which is what makes the eBay Email Scraper useful for cross-border supplier sourcing rather than a single-country contact list.
eBay's long tail of established, business-registered sellers is unusually rich in published trade contacts.
That combination - broad domain reach plus reliable handles - is why this Actor performs so well.

#### Why sourcing and outreach teams use an eBay Email Scraper

Tracking down the company behind an eBay Store is normally a manual chain of clicks: listing, seller profile, store page, contact line.
The eBay Email Scraper compresses that into a single run that sweeps hundreds of Google result pages concurrently and deduplicates as it goes.
Every row is attributable, recording the keyword and the exact query that produced it.

Emails published on eBay seller and store pages are almost always **business addresses**: customer-service inboxes, wholesale desks, trade-enquiry aliases.
That is what makes them appropriate for B2B outreach, and it is also why the responsible-use section below matters.
The eBay Email Scraper touches no private account data, no bidding or order data, and nothing behind a login.

### Key features of the eBay Email Scraper

| Feature | What it means in practice |
|---|---|
| Google-index sourcing | Reads publicly indexed eBay results through the Apify GOOGLE\_SERP proxy - no login, no cookies, no browser |
| `/usr/` and `/str/` resolution | Both seller profiles and eBay Stores yield a handle, normalised to a canonical profile URL |
| Multi-domain coverage | Searches ebay.com, ebay.co.uk, ebay.de and ebay.com.au |
| Query expansion | Base, quoted and `intitle:` variants plus one variant per query modifier; base queries run first |
| Domain filtering | Only emails on the domains listed in `customDomains` are kept |
| Global deduplication | Each address is emitted once per run, across every query and every page |
| Obfuscation handling | Understands `name [at] domain [dot] com`, `name (at) domain`, `name @ domain.com`, `domain .com`, zero-width characters and the full-width `＠` |
| Junk filter | Rejects placeholders such as `email@`, `yourname@`, `test@`, `xxx@` and single-character locals |
| Boundary-correct matching | `@gmail.com` never matches inside `@gmail.company` or `@gmail.com.br` |
| Soft-wrap repair | Drops a hit that is only the tail of another email in the same result block |
| Async concurrency | An `asyncio` worker pool with a shared stop signal on `maxEmails` |
| Retries and block detection | Up to 3 attempts per page with exponential backoff, a fresh proxy session per request, and CAPTCHA / "unusual traffic" / consent pages detected and retried rather than counted as empty |
| Blocked-query requeue | Blocked or failed queries are re-queued once at the end of the run |
| Resumable state | Key-value-store progress keyed by a hash of the input, with throttled saves plus saves on `PERSIST_STATE`, `MIGRATING` and `ABORTING` |
| Layout fallback | A whole-page fallback parser means a Google markup change degrades to "emails without account details", not "no emails" |
| Run summary | Logs pages fetched, blocked pages, retries and emails per page |

### How the eBay Email Scraper works

1. It reads your input - keywords, location, email domains and limits.
2. It builds Google queries with the `site:` operator against the four eBay domains.
3. It fetches result pages asynchronously through the Apify GOOGLE\_SERP proxy using `aiohttp`.
4. It locates each result's `<h3>` title and the smallest surrounding block, so it never depends on Google's CSS class names.
5. It extracts emails from that block text with a domain-filtered regex.
6. It deduplicates globally and pushes each lead to the dataset immediately.

That immediate push means leads appear while the eBay Email Scraper is still running, so an early abort keeps everything collected so far.
State is resumable and keyed by a hash of your input, so a migrated or restarted run continues from where it stopped.
Nothing is buffered until the end.

### eBay Email Scraper input reference

Field names, types and defaults below are exactly what the Actor accepts.

| Field | Type | Default | Meaning |
|---|---|---|---|
| `keywords` | array (required) | `["seller", "store"]` | Search terms describing the eBay accounts you want (niche, job title, industry) |
| `location` | string | `""` | Optional location phrase added to every query |
| `customDomains` | array | `["@gmail.com","@yahoo.com"]` | Only emails on these domains are kept; the leading `@` is optional |
| `maxEmails` | integer 1-10000 | `20` | Stop after this many unique emails |
| `countryCode` | string | `""` | Two-letter country for the search proxy (US, GB, DE, AU...) |
| `expandQueries` | boolean | `true` | Search each keyword x domain pair in several phrasings |
| `queryModifiers` | array | `["email","contact","wholesale","customer service","inquiries"]` | Extra words combined with each keyword when expansion is on |
| `maxPagesPerQuery` | integer 1-50 | `30` | Page cap per query |
| `maxConcurrency` | integer 1-20 | `5` | Parallel queries |

#### Tuning `countryCode` on the eBay Email Scraper

`countryCode` is a real lever here, because this config indexes four eBay domains rather than one.
Setting `GB` biases the search proxy toward UK results and surfaces ebay.co.uk stores far more often; `DE` does the same for ebay.de and `AU` for ebay.com.au.
Running the eBay Email Scraper once per country code usually beats one blended run, and the datasets merge cleanly afterwards.

The default `queryModifiers` - `email`, `contact`, `wholesale`, `customer service`, `inquiries` - are tuned for marketplace trade language.
Swap in `trade account`, `bulk`, `job lot` or `liquidation` when you are sourcing surplus stock rather than doing brand outreach.
Keep `expandQueries` on: Google caps a single query at roughly 300 results, and expansion is how the eBay Email Scraper gets past that ceiling.

#### Example input for the eBay Email Scraper

```json
{
  "keywords": ["vintage watch store", "car parts seller"],
  "location": "United Kingdom",
  "customDomains": ["@gmail.com", "@outlook.com"],
  "maxEmails": 300,
  "countryCode": "GB",
  "expandQueries": true,
  "queryModifiers": ["email", "contact", "wholesale", "customer service", "inquiries"],
  "maxPagesPerQuery": 30,
  "maxConcurrency": 5
}
```

### eBay Email Scraper output fields

Every dataset item carries all fourteen fields below - no more, no fewer.

| Field | Meaning |
|---|---|
| `network` | Platform name |
| `keyword` | The keyword that produced the lead |
| `query` | The exact Google query used |
| `title` | Raw result title |
| `accountName` | Account label Google prints (handle or display name) |
| `fullName` | Display name parsed from a profile-style title; empty for listing captions |
| `username` | URL-safe handle when eBay exposes one; otherwise `null` |
| `profileUrl` | Canonical seller URL when a handle is known; otherwise empty |
| `url` | Direct eBay link when exposed, else the profile URL |
| `description` | Bio or listing snippet, cleaned of labels and engagement counters |
| `email` | Lower-cased email address |
| `emailDomain` | The matched domain (e.g. `@gmail.com`) |
| `possiblyTruncated` | `true` when Google's snippet ellipsis touched the email - verify before sending |
| `foundAt` | ISO 8601 UTC timestamp |

#### Example output from the eBay Email Scraper

The second row shows a `/str/` store page: the handle still resolves, `url` keeps the store link, and `profileUrl` is the canonical `/usr/` form.

```json
[
  {
    "network": "eBay",
    "keyword": "vintage watch store",
    "query": "site:ebay.co.uk vintage watch store contact \"@gmail.com\" \"United Kingdom\"",
    "title": "kestrel_timepieces | eBay Stores",
    "accountName": "kestrel_timepieces",
    "fullName": "Kestrel Timepieces",
    "username": "kestrel_timepieces",
    "profileUrl": "https://www.ebay.com/usr/kestrel_timepieces",
    "url": "https://www.ebay.com/usr/kestrel_timepieces",
    "description": "Trade and wholesale enquiries: kestrel.timepieces@gmail.com. Serviced vintage watches, UK dispatch.",
    "email": "kestrel.timepieces@gmail.com",
    "emailDomain": "@gmail.com",
    "possiblyTruncated": false,
    "foundAt": "2026-08-31T11:21:36Z"
  },
  {
    "network": "eBay",
    "keyword": "car parts seller",
    "query": "site:ebay.com car parts seller wholesale \"@outlook.com\"",
    "title": "Northgate Auto Spares | eBay Stores",
    "accountName": "northgate-auto-spares",
    "fullName": "Northgate Auto Spares",
    "username": "northgate-auto-spares",
    "profileUrl": "https://www.ebay.com/usr/northgate-auto-spares",
    "url": "https://www.ebay.com/str/northgate-auto-spares",
    "description": "Customer service: parts@northgateauto.outlook.com. Bulk and trade orders welcome.",
    "email": "parts@northgateauto.outlook.com",
    "emailDomain": "@outlook.com",
    "possiblyTruncated": true,
    "foundAt": "2026-08-31T11:23:09Z"
  }
]
```

### Use cases for the eBay Email Scraper

| Who | How they use the eBay Email Scraper |
|---|---|
| Wholesale buyers | Shortlist eBay Stores in a category and send trade-account enquiries |
| Liquidation and surplus traders | Reach high-volume sellers who publish a bulk or job-lot contact |
| Marketplace agencies | Prospect for listing-optimisation, advertising and account-management clients |
| Brand-protection teams | Collect published contact points for sellers listing against a protected brand |
| Dropshippers | Identify suppliers advertising a wholesale or inquiries inbox |
| B2B sales teams | Reach eBay business sellers with logistics, packaging, repricing or software offers |
| Market researchers | Compare which eBay categories and countries publish trade contacts |
| Recruiters | Find marketplace operators and e-commerce managers who are hiring |

A productive pattern is to run the eBay Email Scraper narrowly - one category, one country code - then merge the datasets.
Narrow runs keep attribution clean, because `keyword` and `query` record which phrasing produced each lead.
That turns your search language into something you can measure and iterate on.

If eBay is one channel among several, the same engine covers the rest of the marketplace map - the [Walmart Email Scraper](https://apify.com/leads-scraper/walmart-email-scraper) is the other top performer, and the [Amazon Email Scraper](https://apify.com/leads-scraper/amazon-email-scraper) adds five Amazon domains including Amazon Business.
For handmade and craft supply chains, use the [Etsy Email Scraper](https://apify.com/leads-scraper/etsy-email-scraper).
For secondhand and resale niches, the [Mercari Email Scraper](https://apify.com/neuro-scraper/mercari-email-scraper) and [Depop Email Scraper](https://apify.com/leads-scraper/depop-email-scraper) sit closest to eBay's audience.

### eBay Email Scraper limitations - stated honestly

- **Publicly indexed emails only.** If an address is not visible in Google's index, the eBay Email Scraper cannot find it. It does not crawl ebay.com.
- **Google's result ceiling.** A single query returns roughly 300 results at most, which is exactly why `expandQueries` and `queryModifiers` exist.
- **`possiblyTruncated`.** Rows where Google's snippet ellipsis touched the address are flagged `true`. Verify those before sending.
- **Apify GOOGLE\_SERP proxy required.** The eBay Email Scraper cannot run without Apify proxy credentials.
- **Free-plan cap.** Free Apify plans are capped at 100 emails per run; paid plans are uncapped.
- **`username` and `profileUrl` are conditional.** They are filled only when Google's result exposes a handle. eBay resolves well, but a row without one still carries `accountName` and `fullName`. This is a Google indexing limitation, not a bug.
- **No volume guarantee.** Results vary with keywords, domains, country and location. No count is promised.

### Responsible use

Emails published on eBay listings, seller profiles and Stores are usually business or customer-service addresses posted for trade enquiries.
Treat them as B2B contact points, keep outreach relevant, honour opt-outs, and record a lawful basis if you operate under GDPR, PECR or similar rules.
Review eBay's terms and your local marketing law before you send - the eBay Email Scraper collects public data, but what you do with it is your responsibility.

This Actor is not affiliated with, endorsed by or officially supported by eBay.

### FAQ about the eBay Email Scraper

#### Does the eBay Email Scraper log into eBay?

No. It never logs in, never uses eBay's API and never opens ebay.com. Everything comes from publicly indexed Google search results.

#### Does it handle eBay Stores as well as seller profiles?

Yes. Both `/usr/` and `/str/` paths yield a handle, and the eBay Email Scraper normalises each to the canonical `https://www.ebay.com/usr/{username}` profile URL.

#### Which eBay domains does it search?

ebay.com, ebay.co.uk, ebay.de and ebay.com.au.

#### Is `countryCode` worth setting?

Yes - with four domains in scope it meaningfully shifts which regional results the search proxy returns. Run one job per country code for the cleanest coverage.

#### Can it find emails on any domain?

Only the domains you list in `customDomains`. The default is `@gmail.com` and `@yahoo.com`; add corporate domains to widen the net.

#### How many emails can one run return?

Up to `maxEmails`, which accepts 1 to 10000. Free Apify plans are capped at 100 emails per run; paid plans are uncapped.

#### What does `possiblyTruncated: true` mean?

Google's snippet ellipsis touched that address, so it may be cut off. Verify before adding it to a send list.

#### Does it need proxies?

Yes - the Apify GOOGLE\_SERP proxy. The eBay Email Scraper cannot run without Apify proxy credentials.

#### Can I resume an interrupted run?

Yes. Progress lives in the key-value store, keyed by a hash of your input, and is saved on `PERSIST_STATE`, `MIGRATING` and `ABORTING` events.

#### What if Google changes its result markup?

Parsing is structural - the `<h3>` title plus its smallest surrounding block - with a whole-page fallback parser behind it. A layout change degrades to "emails without account details", not "no emails".

#### How do I get more leads?

Use specific category keywords, keep `expandQueries` on, widen `customDomains`, raise `maxPagesPerQuery` and split runs by `countryCode`.

#### Are the emails verified?

No. The eBay Email Scraper extracts what is published in the index. Run your own verification before a campaign.

### Getting started with the eBay Email Scraper

1. Open the eBay Email Scraper on Apify and press **Try for free**.
2. Replace the default `keywords` (`seller`, `store`) with your own category terms.
3. Add the email domains you care about to `customDomains`.
4. Set `countryCode` for the eBay domain you want, raise `maxEmails`, and run it.
5. Export the dataset from the **Storage** tab when the eBay Email Scraper finishes.

Start small - a `maxEmails` of 20 to 50 - to confirm your keywords and domains are pulling the right kind of seller.
Once a keyword set is producing useful rows, re-run the eBay Email Scraper with a higher cap and more pages per query.

#### Exporting eBay Email Scraper results

Every eBay Email Scraper run writes to a standard Apify dataset, so you can download CSV, JSON, XML or Excel, or pull the rows through the Apify API and the JavaScript or Python clients.
The default dataset view surfaces the fields most people need first: email, account, name, username, profile, keyword, bio snippet and the truncation flag.
Deduplication is per run, so keep your own master list when you merge several eBay Email Scraper datasets together.

### Related Actors

The eBay Email Scraper belongs to a 41-Actor E-commerce & Marketplaces family sharing this engine.

| Actor | What it collects |
|---|---|
| [eBay Email and Phone Number Scraper](https://apify.com/neuro-scraper/ebay-email-and-phone-number-scraper) | Emails and phone numbers from eBay |
| [eBay Phone Number Scraper](https://apify.com/neuro-scraper/ebay-phone-number-scraper) | Public phone numbers from eBay |
| [AliExpress Email Scraper](https://apify.com/neuro-scraper/aliexpress-email-scraper) | Public contact emails from AliExpress |
| [Allegro Email Scraper](https://apify.com/neuro-scraper/allegro-email-scraper) | Public contact emails from Allegro |
| [Amazon Email Scraper](https://apify.com/leads-scraper/amazon-email-scraper) | Public contact emails from Amazon |
| [Best Buy Seller Email Scraper](https://apify.com/leads-scraper/best-buy-seller-email-scraper) | Public contact emails from Best Buy |
| [BigCommerce Store Email Scraper](https://apify.com/neuro-scraper/bigcommerce-store-email-scraper) | Public contact emails from BigCommerce Store |
| [Cdiscount Email Scraper](https://apify.com/neuro-scraper/cdiscount-email-scraper) | Public contact emails from Cdiscount |
| [Coupang Email Scraper](https://apify.com/neuro-scraper/coupang-email-scraper) | Public contact emails from Coupang |
| [Depop Email Scraper](https://apify.com/leads-scraper/depop-email-scraper) | Public contact emails from Depop |
| [DHgate Email Scraper](https://apify.com/neuro-scraper/dhgate-email-scraper) | Public contact emails from DHgate |
| [Ecwid Store Email Scraper](https://apify.com/neuro-scraper/ecwid-store-email-scraper) | Public contact emails from Ecwid Store |
| [Etsy Email Scraper](https://apify.com/leads-scraper/etsy-email-scraper) | Public contact emails from Etsy |
| [Faire Email Scraper](https://apify.com/leads-scraper/faire-email-scraper) | Public contact emails from Faire |
| [Flipkart Email Scraper](https://apify.com/leads-scraper/flipkart-email-scraper) | Public contact emails from Flipkart |
| [Home Depot Seller Email Scraper](https://apify.com/leads-scraper/home-depot-seller-email-scraper) | Public contact emails from Home Depot |
| [JD.com Email Scraper](https://apify.com/leads-scraper/jd-com-email-scraper) | Public contact emails from JD.com |
| [Lazada Email Scraper](https://apify.com/neuro-scraper/lazada-email-scraper) | Public contact emails from Lazada |
| [Lowe's Seller Email Scraper](https://apify.com/leads-scraper/lowes-seller-email-scraper) | Public contact emails from Lowe's |
| [MercadoLibre Email Scraper](https://apify.com/neuro-scraper/mercadolibre-email-scraper) | Public contact emails from MercadoLibre |
| [Mercari Email Scraper](https://apify.com/neuro-scraper/mercari-email-scraper) | Public contact emails from Mercari |
| [Newegg Email Scraper](https://apify.com/leads-scraper/newegg-email-scraper) | Public contact emails from Newegg |
| [Otto Email Scraper](https://apify.com/leads-scraper/otto-email-scraper) | Public contact emails from Otto |
| [Overstock Email Scraper](https://apify.com/leads-scraper/overstock-email-scraper) | Public contact emails from Overstock |
| [Poshmark Email Scraper](https://apify.com/leads-scraper/poshmark-email-scraper) | Public contact emails from Poshmark |
| [Rakuten Email Scraper](https://apify.com/neuro-scraper/rakuten-email-scraper) | Public contact emails from Rakuten |
| [Shopee Email Scraper](https://apify.com/leads-scraper/shopee-email-scraper) | Public contact emails from Shopee |
| [Shopify Store Email Scraper](https://apify.com/leads-scraper/shopify-store-email-scraper) | Public contact emails from Shopify Store |
| [Taobao Email Scraper](https://apify.com/leads-scraper/taobao-email-scraper) | Public contact emails from Taobao |
| [Target Seller Email Scraper](https://apify.com/neuro-scraper/target-seller-email-scraper) | Public contact emails from Target |
| [Temu Email Scraper](https://apify.com/leads-scraper/temu-email-scraper) | Public contact emails from Temu |
| [Tmall Email Scraper](https://apify.com/leads-scraper/tmall-email-scraper) | Public contact emails from Tmall |
| [Vinted Email Scraper](https://apify.com/leads-scraper/vinted-email-scraper) | Public contact emails from Vinted |
| [Walmart Email Scraper](https://apify.com/leads-scraper/walmart-email-scraper) | Public contact emails from Walmart |
| [Wayfair Email Scraper](https://apify.com/neuro-scraper/wayfair-email-scraper) | Public contact emails from Wayfair |
| [Wish Email Scraper](https://apify.com/leads-scraper/wish-email-scraper) | Public contact emails from Wish |
| [Wix Stores Email Scraper](https://apify.com/leads-scraper/wix-stores-email-scraper) | Public contact emails from Wix Stores |
| [WooCommerce Email Scraper](https://apify.com/neuro-scraper/woocommerce-email-scraper) | Public contact emails from WooCommerce |
| [Zalando Email Scraper](https://apify.com/leads-scraper/zalando-email-scraper) | Public contact emails from Zalando |
| [AliExpress Email and Phone Number Scraper](https://apify.com/neuro-scraper/aliexpress-email-and-phone-number-scraper) | Emails and phone numbers from AliExpress |
| [Allegro Email and Phone Number Scraper](https://apify.com/neuro-scraper/allegro-email-and-phone-number-scraper) | Emails and phone numbers from Allegro |
| [Amazon Email and Phone Number Scraper](https://apify.com/leads-scraper/amazon-email-and-phone-number-scraper) | Emails and phone numbers from Amazon |

### Leave a review

If the eBay Email Scraper saved you time, please leave a star rating and a short review on the
Actor page.

Reviews are how other buyers judge whether a tool works, and they tell us which features to
build next.

If something did not work, email <neurodata.apify@gmail.com>
instead - bugs get fixed faster than they get complained about.

### Support

Questions, a bug, or need a custom build? Email **neurodata.apify@gmail.com**.

# Actor input Schema

## `keywords` (type: `array`):

Search terms describing the eBay accounts you want (niche, job title, industry).

## `location` (type: `string`):

Optional location phrase added to every query (e.g. "New York").

## `customDomains` (type: `array`):

Only emails ending with one of these domains are collected. With or without the leading @. Each domain is searched separately, so more domains means more results but a longer run - remove some for a faster, narrower search, or add your own (e.g. @company.com).

## `maxEmails` (type: `integer`):

Stop once this many unique emails have been collected.

## `countryCode` (type: `string`):

Two-letter country code for the search proxy (e.g. US, GB, DE). Empty for any.

## `expandQueries` (type: `boolean`):

Search each keyword x domain pair with several phrasings. Recommended - Google caps a single query at ~300 results.

## `queryModifiers` (type: `array`):

Extra words combined with each keyword when Expand queries is on. Tuned for eBay.

## `maxPagesPerQuery` (type: `integer`):

Google rarely returns more than ~30 pages for one query.

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

How many queries run in parallel.

## Actor input object example

```json
{
  "keywords": [
    "seller",
    "store"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "maxEmails": 20,
  "countryCode": "",
  "expandQueries": true,
  "queryModifiers": [
    "email",
    "contact",
    "wholesale",
    "customer service",
    "inquiries"
  ],
  "maxPagesPerQuery": 30,
  "maxConcurrency": 5
}
```

# Actor output Schema

## `results` (type: `string`):

Records produced by eBay Email Scraper, stored in the run's default dataset.

# 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 = {
    "keywords": [
        "seller",
        "store"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com"
    ],
    "countryCode": "",
    "queryModifiers": [
        "email",
        "contact",
        "wholesale",
        "customer service",
        "inquiries"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("leads-scraper/ebay-email-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 = {
    "keywords": [
        "seller",
        "store",
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com",
    ],
    "countryCode": "",
    "queryModifiers": [
        "email",
        "contact",
        "wholesale",
        "customer service",
        "inquiries",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("leads-scraper/ebay-email-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 '{
  "keywords": [
    "seller",
    "store"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "countryCode": "",
  "queryModifiers": [
    "email",
    "contact",
    "wholesale",
    "customer service",
    "inquiries"
  ]
}' |
apify call leads-scraper/ebay-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,leads-scraper/ebay-email-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/GlaRpammRZ1PLFSN0/builds/daHEH0ygOlkgTb3uc/openapi.json
