Skip to main content

  • API License Agreement Update: We have made significant enhancements to our API License Agreement, including detailed data protection measures and compliance with international regulations. Important restrictions have been applied to the use of Restricted APIs and AI content. Developers must review the updated agreement to ensure compliance.
  • 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.
  • We value your feedback! Take our semi-annual Developer Survey and help us build better experiences.

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}