Search Ads 360 API
googleapis · Analytics
The Search Ads 360 API allows developers to automate uploading conversions and downloading reports from Search Ads 360.
Authentication
Sample Requests
Retrieves a list of conversions from a DoubleClick Search engine account.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/customer/{customerId}/conversion?alt=json&key=YOUR_API_KEY&adId=example&fields=example&$.xgafv=1&endDate=1&agencyId=example&callback=example&rowCount=1&startRow=1&adGroupId=example"aUser=example&startDate=1&campaignId=example&uploadType=example&criterionId=example&oauth_token=example&prettyPrint=true&access_token=example&advertiserId=example&engineAccountId=example&upload_protocol=example"import requests
params = {
"alt": "json",
"key": "YOUR_API_KEY",
"adId": "example",
"fields": "example",
"$.xgafv": "1",
"endDate": "1",
"agencyId": "example",
"callback": "example",
"rowCount": "1",
"startRow": "1",
"adGroupId": "example",
"quotaUser": "example",
"startDate": "1",
"campaignId": "example",
"uploadType": "example",
"criterionId": "example",
"oauth_token": "example",
"prettyPrint": "true",
"access_token": "example",
"advertiserId": "example",
"engineAccountId": "example",
"upload_protocol": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/customer/{customerId}/conversion",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/customer/{customerId}/conversion');
url.searchParams.set('alt', 'json');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('adId', 'example');
url.searchParams.set('fields', 'example');
url.searchParams.set('$.xgafv', '1');
url.searchParams.set('endDate', '1');
url.searchParams.set('agencyId', 'example');
url.searchParams.set('callback', 'example');
url.searchParams.set('rowCount', '1');
url.searchParams.set('startRow', '1');
url.searchParams.set('adGroupId', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('startDate', '1');
url.searchParams.set('campaignId', 'example');
url.searchParams.set('uploadType', 'example');
url.searchParams.set('criterionId', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('access_token', 'example');
url.searchParams.set('advertiserId', 'example');
url.searchParams.set('engineAccountId', 'example');
url.searchParams.set('upload_protocol', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/customer/{customerId}/conversion")
q := baseURL.Query()
q.Set("alt", "json")
q.Set("key", "YOUR_API_KEY")
q.Set("adId", "example")
q.Set("fields", "example")
q.Set("$.xgafv", "1")
q.Set("endDate", "1")
q.Set("agencyId", "example")
q.Set("callback", "example")
q.Set("rowCount", "1")
q.Set("startRow", "1")
q.Set("adGroupId", "example")
q.Set("quotaUser", "example")
q.Set("startDate", "1")
q.Set("campaignId", "example")
q.Set("uploadType", "example")
q.Set("criterionId", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("access_token", "example")
q.Set("advertiserId", "example")
q.Set("engineAccountId", "example")
q.Set("upload_protocol", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/customer/{customerId}/conversion")
uri.query = URI.encode_www_form({
"alt" => "json",
"key" => "YOUR_API_KEY",
"adId" => "example",
"fields" => "example",
"$.xgafv" => "1",
"endDate" => "1",
"agencyId" => "example",
"callback" => "example",
"rowCount" => "1",
"startRow" => "1",
"adGroupId" => "example",
"quotaUser" => "example",
"startDate" => "1",
"campaignId" => "example",
"uploadType" => "example",
"criterionId" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"advertiserId" => "example",
"engineAccountId" => "example",
"upload_protocol" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/customer/{customerId}/conversion?" . http_build_query([
"alt" => "json",
"key" => "YOUR_API_KEY",
"adId" => "example",
"fields" => "example",
"$.xgafv" => "1",
"endDate" => "1",
"agencyId" => "example",
"callback" => "example",
"rowCount" => "1",
"startRow" => "1",
"adGroupId" => "example",
"quotaUser" => "example",
"startDate" => "1",
"campaignId" => "example",
"uploadType" => "example",
"criterionId" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"advertiserId" => "example",
"engineAccountId" => "example",
"upload_protocol" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Polls for the status of a report request.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}?alt=json&key=YOUR_API_KEY&fields=example&$.xgafv=1&callback=example"aUser=example&uploadType=example&oauth_token=example&prettyPrint=true&access_token=example&upload_protocol=example"import requests
params = {
"alt": "json",
"key": "YOUR_API_KEY",
"fields": "example",
"$.xgafv": "1",
"callback": "example",
"quotaUser": "example",
"uploadType": "example",
"oauth_token": "example",
"prettyPrint": "true",
"access_token": "example",
"upload_protocol": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}');
url.searchParams.set('alt', 'json');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('$.xgafv', '1');
url.searchParams.set('callback', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('uploadType', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('access_token', 'example');
url.searchParams.set('upload_protocol', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}")
q := baseURL.Query()
q.Set("alt", "json")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("$.xgafv", "1")
q.Set("callback", "example")
q.Set("quotaUser", "example")
q.Set("uploadType", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("access_token", "example")
q.Set("upload_protocol", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}")
uri.query = URI.encode_www_form({
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"$.xgafv" => "1",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}?" . http_build_query([
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"$.xgafv" => "1",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Downloads a report file encoded in UTF-8.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}/files/{reportFragment}?alt=json&key=YOUR_API_KEY&fields=example&$.xgafv=1&callback=example"aUser=example&uploadType=example&oauth_token=example&prettyPrint=true&access_token=example&upload_protocol=example"import requests
params = {
"alt": "json",
"key": "YOUR_API_KEY",
"fields": "example",
"$.xgafv": "1",
"callback": "example",
"quotaUser": "example",
"uploadType": "example",
"oauth_token": "example",
"prettyPrint": "true",
"access_token": "example",
"upload_protocol": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}/files/{reportFragment}",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}/files/{reportFragment}');
url.searchParams.set('alt', 'json');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('$.xgafv', '1');
url.searchParams.set('callback', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('uploadType', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('access_token', 'example');
url.searchParams.set('upload_protocol', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}/files/{reportFragment}")
q := baseURL.Query()
q.Set("alt", "json")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("$.xgafv", "1")
q.Set("callback", "example")
q.Set("quotaUser", "example")
q.Set("uploadType", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("access_token", "example")
q.Set("upload_protocol", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}/files/{reportFragment}")
uri.query = URI.encode_www_form({
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"$.xgafv" => "1",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/doubleclicksearch/v2/doubleclicksearch/v2/reports/{reportId}/files/{reportFragment}?" . http_build_query([
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"$.xgafv" => "1",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Search Ads 360 API?
Search Ads 360 API is a Analytics API. Developers commonly use analytics APIs for:
- tracking product usage and user behaviour
- building custom reporting and BI dashboards
- measuring marketing and campaign performance
- running funnel, retention, and cohort analysis
- aggregating metrics from multiple data sources
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Search Ads 360 API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide