Skip to main content

  • New Feature: The Inventory Mapping API helps you turn your existing product data into high-quality listings with AI-powered recommendations. Learn more here.
  • Important Update: eBay's API integrations will be modified to address data handling requirements for select developers. Usernames will be replaced with immutable user IDs, and financial data will be protected for certain users. Learn more here.
  • Action required: From early May, API users must include standardized condition details when creating or updating listings. Update your integration to stay compliant. Learn more here.

The Leads API lets sellers return leads generated by their classified ad listings and includes any contact information that prospective buyers have submitted. A seller can retrieve leads for listed items for a specified marketplace optionally filtered by specified search criteria. Use this resource to retrieve sales-lead information for classified ad listings. For additional information on classified adds, see Selling with Classified Ads.

The getClassifiedLeadsByItemId method retrieves leads for a specific classified ad listing, while getAllClassifiedLeads method retrieves leads for all active classified ad listings.

Note: This is a Limited Release(Limited Release) API available only to select developers approved by business units. For information on how to obtain access to this API in production, please contact eBay support.

classified_lead

Method NameHTTP MethodPathSummarySamples
getAllClassifiedLeadsGET/classified_leadRetrieves leads for all active classified ad listings.View getAllClassifiedLeads - /classified_lead
getClassifiedLeadsByItemIdGET/classified_lead/{itemId}Returns leads generated for a specified classified ad listing.View getClassifiedLeadsByItemId - /classified_lead/{itemId}