Google Local Services Ads leads

curl --request GET \
  --url https://api.aisa.one/apis/v1/ads/local-services/leads \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/ads/local-services/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/ads/local-services/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/ads/local-services/leads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/ads/local-services/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "customerId": "<string>",
  "data": [
    {
      "categoryId": "<string>",
      "charged": true,
      "contact": {
        "consumerName": "<string>",
        "email": "<string>",
        "phoneNumber": "<string>"
      },
      "createdTime": "<string>",
      "creditState": "<string>",
      "creditStateLastUpdate": "<string>",
      "id": "<string>",
      "leadType": "<string>",
      "locale": "<string>",
      "serviceId": "<string>",
      "status": "<string>"
    }
  ],
  "paging": {
    "nextPageToken": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "<string>",
    "retryable": true,
    "type": "<string>"
  }
}

AIsa Ads

Google Local Services Ads leads

Ad Insights. Read only. Lists the calls, messages and bookings your Google Local Services Ads generated, newest first. Leads (phone calls, messages, bookings) are read live from Google's `local_services_lead` resource. No persistence: Google is the source of truth, and lead/credit statuses keep changing server-side. Google never returns healthcare-category leads.  A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.

GET

https://api.aisa.one

apis

ads

local-services

leads

Google Local Services Ads leads

curl --request GET \
  --url https://api.aisa.one/apis/v1/ads/local-services/leads \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/ads/local-services/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/ads/local-services/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/ads/local-services/leads"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/ads/local-services/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "customerId": "<string>",
  "data": [
    {
      "categoryId": "<string>",
      "charged": true,
      "contact": {
        "consumerName": "<string>",
        "email": "<string>",
        "phoneNumber": "<string>"
      },
      "createdTime": "<string>",
      "creditState": "<string>",
      "creditStateLastUpdate": "<string>",
      "id": "<string>",
      "leadType": "<string>",
      "locale": "<string>",
      "serviceId": "<string>",
      "status": "<string>"
    }
  ],
  "paging": {
    "nextPageToken": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "<string>",
    "retryable": true,
    "type": "<string>"
  }
}

Request contract

Method and path: GET /apis/v1/ads/local-services/leads
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/ads/local-services/leads
connectionId: query; required
adAccountId: query; optional
customerId: query; optional
fromDate: query; optional
toDate: query; optional
leadType: query; optional
leadStatus: query; optional
chargedOnly: query; optional
pageToken: query; optional
Runtime facts: fe60122939c67dc98a3a6ac6b97bd5c326b526105150c8959304dd2160d4dd09

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_aisa_ads_apis_v1_ads_local_services_leads",
  "method": "GET",
  "path": "/apis/v1/ads/local-services/leads",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.",
      "in": "query",
      "name": "connectionId",
      "required": true,
      "schema": {
        "pattern": "^adc_[0-9A-Za-z]+$",
        "type": "string"
      }
    },
    {
      "description": "Platform ad account ID (Google customer ID, digits only). Defaults to the account's connected customer.",
      "in": "query",
      "name": "adAccountId",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Alias of adAccountId, kept for existing callers",
      "in": "query",
      "name": "customerId",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Leads created at/after this day.",
      "in": "query",
      "name": "fromDate",
      "required": false,
      "schema": {
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Leads created at/before this day.",
      "in": "query",
      "name": "toDate",
      "required": false,
      "schema": {
        "format": "date",
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "leadType",
      "required": false,
      "schema": {
        "enum": [
          "PHONE_CALL",
          "MESSAGE",
          "BOOKING"
        ],
        "type": "string"
      }
    },
    {
      "description": "Google LocalServicesLeadStatus enum value (e.g. NEW, BOOKED, WIPED_OUT).",
      "in": "query",
      "name": "leadStatus",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "true = only leads Google charged for.",
      "in": "query",
      "name": "chargedOnly",
      "required": false,
      "schema": {
        "type": "boolean"
      }
    },
    {
      "description": "Cursor from paging.nextPageToken of the previous page.",
      "in": "query",
      "name": "pageToken",
      "required": false,
      "schema": {
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "description": "Ads operations are free. Ad spend is billed by the ad platform to the connected ad account, never by AIsa.",
    "kind": "no_customer_charge"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

connectionId

string

required

The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.

Pattern: ^adc_[0-9A-Za-z]+$

adAccountId

string

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

customerId

string

Alias of adAccountId, kept for existing callers

fromDate

string<date>

Leads created at/after this day.

toDate

string<date>

Leads created at/before this day.

leadType

enum<string>

Available options:

PHONE_CALL,

MESSAGE,

BOOKING

leadStatus

string

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

chargedOnly

boolean

true = only leads Google charged for.

pageToken

string

Cursor from paging.nextPageToken of the previous page.

Response

Local Services leads

customerId

string

data

object[]

Show child attributes

paging

object

Show child attributes

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Request contract

Cost and request rules