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.

adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.

customerIdstring

Alias of adAccountId, kept for existing callers

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

Changes