Skip to main content
GET
Get live Google Ads performance, one row per day, for the campaigns, ad groups or ads you created through Ayrshare.
  • Numbers are read from Google when you call, not from a nightly copy.
  • All money values are in the ad account’s currency, returned in currency on each row.
  • Google leaves out days with no activity, so a range can return fewer rows than it has days.
  • Google adjusts a day’s cost and conversions for a few days after it ends, so recent days can change between reads.
  • For a Performance Max campaign, use level=campaign with the campaign id. A Performance Max campaign has no ads of its own, so level=ad returns no rows.

Header Parameters

Query Parameters

string
required
What each row reports on: campaign (the campaignId from Create), adSet (the adGroupId from Create) or ad (the adId from Create).
string
required
Comma-separated campaign, ad group or ad ids, up to 50. They must all be in one ad account.
string
The 10-digit Google Ads customer id, with or without hyphens (123-456-7890).Ad and ad group reports read the ad account you name here. Without it, an ad report searches every ad account your Google Ads link reaches, up to 25, and an ad group report works only when your link reaches one ad account. Name the account when your link reaches more than 25 ad accounts, or more than one for an ad group report. Otherwise the request answers code: 101.
string
Comma-separated metrics to return. Leave it out to get them all. See Metrics.
string
default:"30 days ago"
First day, as YYYY-MM-DD. Google keeps daily numbers for 37 months; an older startDate answers code: 101.
string
default:"today"
Last day, as YYYY-MM-DD.

Metrics

actions and conversionValue stay 0 until conversion tracking is set up in your Google Ads account. reach is not available, because Google reports no unique reach for Search, and breakdowns are not available on Google. Asking for either answers code: 101.

Paging

Every row comes back in one response, so nextCursor is always null.

Errors