Ads audiences
Show ads to the people who visited your website: send them to Google, LinkedIn and Meta Ads as audiences.
Read your Google Ads retargeting audiences and refresh their numbers. LinkedIn and Meta audiences are managed in the dashboard only.
Authenticated with ?privateKey=YOUR_KEY (see Authentication).
| GET | /v3/google-ads/audiences | List Google Ads audiences |
| GET | /v3/google-ads/audiences/{audienceId} | Get a Google Ads audience |
| POST | /v3/google-ads/audiences/{audienceId}/sync-stats | Refresh Google Ads audience stats |
curl -X GET "https://rest-dash.revealid.xyz/v3/google-ads/audiences?privateKey=YOUR_KEY&websiteId=64b7f0a1c2d3e4f5a6b7c8d9"What each field accepts
| Field | Type | Limits and format | Accepted values |
|---|---|---|---|
| websiteId* | string | — | any |
Use case: List your audiences
GET /v3/google-ads/audiences?websiteId=… answers campaigns (one per audience, newest first), total, page and limit. Each has its _id (the audienceId), name, status, stats (audienceSize, matchRate, impressions, clicks, conversions, ctr, cpc, costMicros = spend in millionths of the account currency, lastSyncedAt), the linked Google campaign (googleCampaignId, googleCampaignName) and contactsCount. The people themselves (email, name, company and whether each was pushed to Google) come with one audience: GET /v3/google-ads/audiences/{audienceId}.
Use case: Refresh the numbers
POST /v3/google-ads/audiences/{audienceId}/sync-stats with websiteId fetches the latest impressions, clicks, conversions, cost, CTR and CPC from Google Ads. It answers 400 until a Google Ads account is picked under Integrations → Google Ads and the audience is linked to a Google campaign.
Use case: Weekly ads report
Read every audience with GET /v3/google-ads/audiences, refresh each one's numbers with POST /v3/google-ads/audiences/{audienceId}/sync-stats, then post the clicks and conversions to your team.