eBay Seller Leads API

Affiliate disclosure: AgentX may earn a commission when you open an Apify account through links on this page, at no extra cost to you.

eBay Seller Leads API converts one supported eBay Store or seller-profile URL into a single 65-field intelligence record. The Dataset combines source lineage, seller and storefront identity, feedback, inventory navigation, contact candidates, collection coverage, and transparent heuristic qualification fields.

• Two URL forms: accepts /str/ storefronts and /usr/ seller profiles across eight documented eBay marketplace domains.
• One bounded result: a successful run writes one normalized seller record rather than an unbounded product list.
• Sixty-five top-level fields: preserves raw source signals alongside nullable business, contact, feedback, inventory, and policy values.
• Decision context included: returns heuristic lead tier, reasons, risks, contactability score, seller segment, and suggested review action.

Run the Anker Official Store example and inspect its one result or open the API documentation. eBay pages, counts, labels, and sign-in behavior change; contact candidates and qualification fields must be verified before outreach or any consequential decision.

Why Choose This API

This Actor is designed for the point where you already know an eBay storefront or seller-profile URL and want a source-aware record for research. It follows the resolved store, seller profile, about, feedback, and contact surfaces when available, then returns one Dataset item with consistent keys. Values that are absent remain null instead of being invented.

The record contains both source signals and locally derived fields. positive_feedback_rate, items_sold, followers, category lists, feedback counts, URLs, and storefront text reflect parsed page content. lead_quality_tier, contactability_score, seller_segment, business_verification_tier, and recommended_next_action are deterministic AgentX heuristics. They are not eBay ratings, identity checks, legal conclusions, or permission to contact a seller.

Contact parsing also needs care. A live Anker run produced a phone-like 12-digit string, no email, and a contact page that required sign-in. Treat values in contact_emails and contact_phone_numbers as candidates, not verified contact details. The observed seller_location was the UI label Shipping to, while member_since included adjacent truncated text. The schema and documentation preserve those imperfections so downstream systems can validate them.

eBay's official feedback documentation says a member profile can show an overall feedback score, positive-rating percentage, recent feedback, detailed seller ratings, and registration date. It does not make the Actor's lead tier authoritative. Keep source metrics and local qualification separate.

Quick Start Guide

Open the Actor and submit one supported Store URL. This shared example targets the public Anker storefront:

{
  "store_url": "https://www.ebay.com/str/ankerdirect"
}

After the run reaches SUCCEEDED, open the default Dataset and confirm that exactly one item was saved. Check query_store_url, resolved_url, store_name, seller_username, and processor first. Then inspect nulls, candidate contact values, and the scrape_quality object before using the derived lead fields.

A prior live run returned Anker Official Store, username ankerdirect, the United States marketplace, 99.8% positive feedback, displayed counts of 999K items sold and 34K followers, ten featured categories, four store sections, and 59 source product URLs. It did not return feedback_score, active-listing count, sample products, business information, emails, price range, or policy summaries. Availability on another profile can differ substantially.

If no item is written, confirm that the URL matches the supported host and path rules, opens publicly, and has not redirected to an unrelated page. A terminal success alone is not enough; verify Dataset count and content.

Input Parameters

Field	Type	Required	Rules
store_url	string	Yes	HTTP/HTTPS eBay URL whose path begins with /str/ or /usr/

Supported marketplace hosts are ebay.com, ebay.com.au, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, and ebay.ca, including ordinary eBay subdomains. Lookalike hosts are rejected. The runtime trims surrounding whitespace and keeps the submitted URL as query_store_url.

The prefilled Anker URL is an example, not a hidden fallback for API callers. Only one URL is accepted per run. For a list of sellers, orchestrate separate calls through an Apify Task, client, schedule, or queue, and retain each run ID and Dataset ID.

An /str/ URL starts from a storefront, while an /usr/ URL starts from a member profile. The Actor can still discover linked surfaces, but the source type and available fields may differ. Do not assume identical coverage across countries, store designs, or account types.

Output Data Schema

Every saved record contains 65 top-level keys grouped below:

Group	Fields
Processing and source	processor, processed_at, platform, source_url, query_store_url, resolved_url, status
Local qualification	lead_quality_tier, lead_quality_reasons, risk_flags, recommended_next_action, contactability_score, seller_segment, business_verification_tier, qualification_summary
Store and seller identity	store_id, store_slug, store_name, store_url, seller_profile_url, seller_username, seller_profile_about
Market and reputation	country, country_code, market_domain, positive_feedback_rate, items_sold, followers, seller_location, member_since, feedback_score, feedback_rating_star, feedback_breakdown, feedback_url
Contact candidates	contact_url, contact_page_available, contact_page_requires_sign_in, seller_contact_route, contact_emails, contact_phone_numbers, contact_methods, contact_topics
About and brand	about_url, about, about_full_text, logo_image_url, banner_image_url, store_description, business_info, external_links
Inventory and navigation	active_listings, inventory_total_items, featured_categories, store_categories, store_sections, store_sections_detailed, source_product_urls, last_seen_at, sample_products, sample_products_count, price_range
Policies and diagnostics	shipping_policy_summary, return_policy_summary, payment_policy_summary, scrape_quality

{
  "processor": "https://apify.com/agentx/ebay-seller-leads-api?fpr=aiagentapi",
  "processed_at": "2026-07-23T11:43:36+00:00",
  "platform": "eBay United States Store Profile",
  "lead_quality_tier": "C",
  "lead_quality_reasons": ["public_phone_available", "contactable_profile", "reputation_signals_available", "inventory_signals_available", "brand_presence_signals_available"],
  "risk_flags": ["missing_business_information", "contact_page_requires_sign_in"],
  "recommended_next_action": "research_more",
  "contactability_score": 40,
  "seller_segment": "brand_store",
  "business_verification_tier": "missing",
  "qualification_summary": "C-tier brand_store with contactable profile, missing business verification, and moderate reputation signals.",
  "source_url": "https://www.ebay.com/str/ankerdirect",
  "query_store_url": "https://www.ebay.com/str/ankerdirect",
  "resolved_url": "https://www.ebay.com/str/ankerdirect",
  "store_id": "ankerdirect",
  "store_slug": "ankerdirect",
  "store_name": "Anker Official Store",
  "store_url": "https://www.ebay.com/str/ankerdirect",
  "seller_profile_url": "https://www.ebay.com/usr/ankerdirect",
  "seller_username": "ankerdirect",
  "seller_profile_about": "Store profile text",
  "country": "United States",
  "country_code": "US",
  "market_domain": "ebay.com",
  "positive_feedback_rate": "99.8%",
  "items_sold": "999K",
  "followers": "34K",
  "seller_location": "Shipping to",
  "member_since": "Mar-04-10 in United States Top-rated sel",
  "feedback_score": null,
  "feedback_rating_star": null,
  "active_listings": null,
  "inventory_total_items": null,
  "feedback_breakdown": {"positive": {"last_1_month": 2169, "last_6_months": 13751, "last_12_months": 29516}, "neutral": {"last_1_month": 2, "last_6_months": 21, "last_12_months": 73}, "negative": {"last_1_month": 4, "last_6_months": 20, "last_12_months": 51}},
  "feedback_url": "https://www.ebay.com/fdbk/feedback_profile/ankerdirect",
  "contact_url": "https://www.ebay.com/cnt/intermediatedFAQ?requested=ankerdirect",
  "contact_page_available": true,
  "contact_page_requires_sign_in": true,
  "seller_contact_route": "sign_in_required",
  "contact_emails": null,
  "contact_phone_numbers": ["335822470022"],
  "contact_methods": ["phone"],
  "contact_topics": ["Payments Terms of Use"],
  "about_url": "https://www.ebay.com/str/ankerdirect?_tab=about",
  "about": "Store profile text",
  "about_full_text": "Store profile text",
  "logo_image_url": "https://i.ebayimg.com/images/g/example/s-l140.jpg",
  "banner_image_url": "https://i.ebayimg.com/images/g/example/s-l1600.png",
  "store_description": "Store profile text",
  "business_info": null,
  "featured_categories": ["Chargers", "Wall Charger", "Car Charger"],
  "store_categories": [{"name": "Chargers", "url": "https://www.ebay.com/str/ankerdirect/Chargers/_i.html"}],
  "store_sections": ["Featured categories", "Best Sellers", "Newly Listed", "All items"],
  "store_sections_detailed": [{"name": "Featured categories"}],
  "source_product_urls": ["https://www.ebay.com/itm/335394957507"],
  "last_seen_at": "2026-07-23T11:43:36+00:00",
  "sample_products": null,
  "sample_products_count": 0,
  "price_range": null,
  "shipping_policy_summary": null,
  "return_policy_summary": null,
  "payment_policy_summary": null,
  "external_links": null,
  "scrape_quality": {"source_type": "store", "pages_fetched": 10, "product_links_collected": 59, "product_detail_pages_requested": false, "seller_profile_page_requested": true, "about_page_requested": true, "contact_page_requested": true, "feedback_page_requested": true},
  "status": "success"
}

The example mirrors an observed shape but shortens long text and arrays. A non-null candidate is not automatically correct. Preserve the source URL and apply business-specific validation.

Integration Examples

Call the Actor asynchronously through REST, keep the token secret, and fetch the Dataset after terminal success:

$curl -X POST "https://api.apify.com/v2/acts/agentx~ebay-seller-leads-api/runs?token=$APIFY_TOKEN&waitForFinish=180" -H "Content-Type: application/json" -d '{"store_url":"https://www.ebay.com/str/ankerdirect"}'

Production clients should handle validation errors, eBay redirects, source blocking, missing pages, null values, changed markup, false-positive contact candidates, and charge limits. Check that one item exists and inspect its source and qualification reasons rather than trusting only the run status.

For an Apify MCP connection, fetch current Actor details before execution and pass:

{
  "store_url": "https://www.ebay.com/str/ankerdirect"
}

MCP access depends on the connected account, token, plan, and refreshed schema. If execution is unavailable, use Console or the authenticated API. Always read the Dataset after the call.

Pricing & Cost Calculator

eBay Seller Leads API uses pay-per-event pricing. The Result event is charged once for the single profile saved by a successful run.

Event	Free	Bronze	Silver	Gold / Platinum / Diamond
One Result	$0.45000	$0.43500	$0.42000	$0.40500
Actor start	$0.01000	$0.01000	$0.01000	$0.01000
Actor usage	$0.00001 per event	Same	Same	Same

For a Free-tier run that writes one result and records 200 usage events, the illustration is $0.45000 + $0.01000 + (200 × $0.00001) = $0.46200. Usage count varies. A failed or empty run may still incur start and usage events, while a successful profile normally has one Result event.

Review the live pricing panel before production use. Set a maximum-total-charge value that accommodates one Result plus start and variable usage; an undersized cap can prevent a paid result from being written.

Use Cases & Applications

Seller research: collect storefront identity, seller username, marketplace, about text, feedback signals, and source links into a review queue.

CRM enrichment: attach an eBay presence to an already matched company. Keep contact candidates quarantined until a person verifies them against the source and applicable outreach rules.

Supplier screening: use feedback breakdowns, displayed items sold, categories, inventory URLs, and missing-field risks as inputs to broader due diligence. Do not treat a C-tier or high feedback percentage as proof of legitimacy or fulfillment quality.

Category mapping: compare featured_categories, store_categories, store sections, and product URLs across known sellers. Store categories are seller-configured and need not match eBay's standard taxonomy.

Monitoring: schedule the same URL and compare source metrics over time. Retain run timestamps and distinguish parser drift or unavailable pages from real seller changes.

Marketplace portfolio analysis: normalize known seller URLs from different supported eBay domains, then compare marketplace, reputation, brand, navigation, and inventory signals using the same column set. Avoid ranking rows that have different coverage without accounting for nulls and scrape_quality.

Human review queues: use lead_quality_reasons and risk_flags to prioritize which profiles an analyst opens first. The recommended action is a triage label only. A reviewer should confirm the business identity, contact route, reputation context, and product relevance before moving a record into an outreach or supplier workflow.

For repeatable analysis, store the input URL, Actor version, run time, and selected source fields alongside any downstream decision. If an enrichment changes later, this evidence helps determine whether the seller changed, eBay changed the page, or the extraction coverage changed.

FAQ

How many records does one run return? At most one normalized seller profile. A blocked, invalid, or empty source can return zero.

Which eBay URLs work? Supported domains with /str/ or /usr/ paths.

Are contact emails and phone numbers verified? No. They are parser-detected candidates and can be null or false positives.

Is contactability_score an eBay metric? No. It is a local heuristic based on available candidate contact routes and links.

Does business_verification_tier mean eBay verified the seller? No. It measures completeness of parsed business fields only.

Why are active listings or sample products null? The source or current collection path may expose product URLs without producing listing counts or sample product objects.

Can seller_location be wrong? It can contain nearby UI text such as Shipping to; validate it before geographic use.

Does positive feedback guarantee a safe supplier? No. Use eBay's source context and independent due diligence.

Trust & Certifications

Trust is grounded in reproducible evidence, not badges. The input schema matches the runtime's one required field, the Dataset schema covers all 65 formatter keys, and a public MCP run of the Anker example returned one profile with all 65 top-level keys. That test demonstrates one deployed path, not universal coverage or future availability.

eBay's official feedback profiles page explains the source feedback score, positive percentage, recent feedback, ratings, and registration-date concepts. Contacting a seller explains that contact options can depend on transaction context, seller settings, and sign-in. Managing an eBay Store explains that sellers can create custom Store categories. These sources describe eBay and do not endorse this Actor.

No identity, contact accuracy, security, legal, compliance, deliverability, seller quality, uptime, or data-completeness certification is claimed.

Legal & Compliance

Use the Actor for legitimate purposes and comply with eBay's current terms, Apify policies, applicable law, privacy rules, intellectual-property obligations, and communication restrictions. eBay warns against using contact information to complete transactions outside its platform; do not use this data to evade marketplace protections or policies.

Minimize personal data, control Dataset access, define retention limits, and verify every contact candidate before use. Apply human review to supplier selection, credit, employment, insurance, fraud allegations, or other consequential actions. Seller names, feedback, categories, and displayed counts can change.

eBay Seller Leads API is independent and is not affiliated with, endorsed by, or operated by eBay.

Related Tools

Broaden marketplace research with All Shopping Scraper, compare public business surfaces through Google Maps Store Scraper, or explore employer and company discovery with All Jobs Scraper.

Enrich a verified entity through LinkedIn Company Lookup, study demand language with Google Keyword Trends, or examine a public social presence with Instagram Creator Scraper. Each tool has an independent schema, price, coverage, and legal context.

Support & Community

Use the Actor's Issues tab in Apify Console or contact AgentX support. Include the sanitized eBay URL, run ID, Dataset ID, expected behavior, actual behavior, and a short log excerpt. For a suspected false-positive contact value, identify the field without sharing unrelated personal data. Never send API tokens.

Last updated: July 23, 2026. The live input schema, pricing panel, run Dataset, and current eBay documentation are authoritative if this page becomes outdated.