Google

Keyword or search term performance from Google Ads

Fetches a Google Ads keyword performance or search terms report for one customer and up to 31 days (from and to included). Use the keyword report to review the account's selected terms and the search-terms report to review queries recorded in that account. Rows carry clicks, impressions, cost in micros of the Google Ads account currency (divide by 1,000,000), conversions and conversion value. This is the connected customer's own advertising data; it reports that account's costs and conversions, and competitor spend cannot be inferred from it. Interpret conversions in light of the account's configured conversion actions and attribution. It is separate from saved ad observations. Page with next_page_token. Reads Google's data live with the connection of the person the credential acts for; nothing is saved and it uses no check allowance. Connecting or reconnecting needs Google sign-in in the app (Settings > Connections).

get/projects/{project_id}/google-connections/{connection_id}/ads-report

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/google-connections/{connection_id}/ads-report
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.

connection_idstring required

The connection id from list_google_connections.

Query parameters

customer_idstring required

Customer id from list_google_accounts, such as 1234567890.

login_customer_idstring

Manager account id when the customer is reached through a manager.

fromstring required

First day, YYYY-MM-DD.

tostring required

Last day, YYYY-MM-DD, at most 30 days after from.

report'keywords' | 'search-terms'
page_tokenstring

Response

Keyword or search term performance from Google Ads

next_page_tokenstring nullable required
fetched_atstring required
request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.