Google Safe Browsing API

by google.com

Overview

Google Link/Domain Flagging

Google Safe Browsing is an anti-malware API from google.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 23 endpoints.

At a glance

Authentication: API key
HTTPS: Yes
CORS: Unknown
Category: Anti-Malware
Base URL: https://travelpartner.googleapis.com/
Version: v3
Endpoints: 23
OpenAPI: Specification ↗
Spec updated: 2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://travelpartner.googleapis.com/v3/NAME" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("https://travelpartner.googleapis.com/v3/NAME", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://travelpartner.googleapis.com/v3/NAME",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
POST	`/v3/{account}/hotels:setLiveOnGoogle`	Collection-level custom method to update the Live on Google status for multiple properties. Each call can turn on or off multiple hotels. To turn some hotels on
GET	`/v3/{name}`	Returns a reconciliation report.
PATCH	`/v3/{name}`	Updates a brand.
DELETE	`/v3/{name}`	Deletes an account link.
GET	`/v3/{name}/freeBookingLinksReportViews:query`	DEPRECATED: Use PropertyPerformanceReportService.QueryPropertyPerformanceReport, which also has impression reporting, instead. Provides the ability to query
GET	`/v3/{name}/participationReportViews:query`	Provides the ability to query (get, filter, and segment) a participation report for a particular account.
GET	`/v3/{name}/propertyPerformanceReportViews:query`	Provides the ability to query (get, filter, and segment) a property performance links report for a specific account.
GET	`/v3/{parent}/accountLinks`	Returns the account links for a Hotel Center account.
POST	`/v3/{parent}/accountLinks`	Creates a new account link between a Hotel Center account and a Google Ads account.
GET	`/v3/{parent}/brands`	Returns the brands for a partner account.
POST	`/v3/{parent}/brands`	Creates a new brand. Because Google detects brands from your existing properties, you only need this operation when you want to configure a brand before you sen
GET	`/v3/{parent}/hotelViews`	Returns the list of hotel views.
GET	`/v3/{parent}/hotelViews:summarize`	Returns summarized information about hotels.
GET	`/v3/{parent}/icons`	Returns the `Icon`s for a partner account.
POST	`/v3/{parent}/icons`	Uploads a new icon and starts its review process. Generates an `icon_id` and includes it in the icon's resource name, which is the format `accounts/{account_id}
POST	`/v3/{parent}/listings:verify`	returns verified listings with data issues and serving eligibilities
GET	`/v3/{parent}/priceAccuracyViews`	Lists the available price accuracy views.
GET	`/v3/{parent}/priceAccuracyViews:summarize`	Returns the price accuracy summary.
GET	`/v3/{parent}/priceCoverageViews`	Returns the entire price coverage history.
GET	`/v3/{parent}/priceCoverageViews:latest`	Returns the latest price coverage view in full detail.
GET	`/v3/{parent}/reconciliationReports`	Returns a list of the names of created reconciliation reports.
POST	`/v3/{parent}/reconciliationReports`	Creates a reconciliation report and uploads it to Google.
POST	`/v3/{parent}/reconciliationReports:validate`	Validates a reconciliation report.