Retrieve leads using Google Ads API
For technical questions regarding the Google Ads API, Data Manager API, or SDK including specific usage queries or error codes, follow the troubleshooting steps on the technical support page of Data Manager API or Google Ads API. For issues with conversion tracking, offline uploads, or data discrepancies, refer to the Conversion management guide and Debug common errors in the developer documentation. Before contacting support, verify your conversion_action_ids, check statuses in the User interface, and ensure you've accepted all data terms.
If you need further help, provide complete API logs (including request, response headers, and IDs) along with uncropped screenshots of the Google Ads interface.
If you have questions concerning Data Manager API or Google Ads API that relate to the Google Ads UI specifically, select “Contact us” at the bottom of the page.
You can set up the Google Ads API to automatically send lead data from Google Ads into your customer relationship management (CRM) system or data management platform (DMP).
In this article, you’ll learn about retrieving leads through the Google Ads API.
On this page
- Benefits
- Access the Google Ads API to export leads
- Use the Google Ads API for exporting lead form data
- Retrieve up to 60 days worth of leads
- Newly submitted leads are available to be retrieved in near real time
- Integrate your Google Ads account with a supported CRM or DMP so you can manage your leads in the platform of your choice
The Google Ads API delivers lead data directly to your CRM from any accounts you own or manage, eliminating the need for CSV downloads or webhooks. Ensure you’ve at least one active lead form to begin with. Learn more about LeadFormAsset.
To export lead data through the API, you need a developer token. If you are an existing Google Ads API, you can use your current token. If you are a new user, you must set up a manager account initially and manage account structure to obtain one. Learn how to Obtain a developer token.
Review the developers guide to learn how to perform lead export tasks with the Google Ads API, like authorizing the CRM of your choice.