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).
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
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.
The connection id from list_google_connections.
Query parameters
Customer id from list_google_accounts, such as 1234567890.
Manager account id when the customer is reached through a manager.
First day, YYYY-MM-DD.
Last day, YYYY-MM-DD, at most 30 days after from.
Response
Keyword or search term performance from Google Ads
Changes
No recorded changes to this operation across all 1 revision of this API.