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

  • 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

Access the Google Ads API to export leads

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 to enable the Google Ads API in your Google Cloud project and configure appropriate OAuth 2.0 credentials. Navigate to the Google Ads API Overview page and apply for API Access.

You can manage API access directly in the Google Cloud Console. You no longer need to get a developer token or use the API Center within a Google Ads manager account (MCC) specifically to provision API. Learn how to make a Google Ads API call.

Use the Google Ads API for exporting lead form data

Review the developers guide to learn how to perform lead export tasks with the Google Ads API, like authorizing the CRM of your choice.

Related links

Search
Clear search
Close search
Google apps
Main menu
4368607166829499688
true
Search Help Center
true
true
true
true
true
true
73067
false
false
true
true
false
false