Sign in
latestOpenAPI 3.1.02026-08-215701892.2 MB

15e893e69e8c

Ad Insights

Google Local Services Ads leads

Leads generated by Local Services Ads (phone calls, messages, bookings), read live from Google's local_services_lead resource, newest first. No persistence: Google is the source of truth and lead/credit statuses keep changing server-side. Google never returns healthcare-category leads, and WIPED_OUT leads arrive with contact erased (contact is null). Draws on the shared Google Ads operations budget.

get/v1/ads/local-services/leads

Query parameters

accountIdstring required

Google ads SocialAccount id.

customerIdstring

Numeric Google Ads customer id (no dashes). Defaults to the account's connected customer.

fromDatestring date

Leads created at/after this day.

toDatestring date

Leads created at/before this day.

leadType'PHONE_CALL' | 'MESSAGE' | 'BOOKING'
leadStatusstring

Google LocalServicesLeadStatus enum value (e.g. NEW, BOOKED, WIPED_OUT).

chargedOnlyboolean

true = only leads Google charged for.

pageTokenstring

Cursor from paging.nextPageToken of the previous page.

Response

Local Services leads

customerIdstring