Skip to main content
GET
/
api
/
v1
/
google-ads
/
ads
Get Ads Data
curl --request GET \
  --url http://localhost:8000/api/v1/google-ads/ads \
  --header 'Authorization: Bearer <token>'
[
  {
    "ad_id": "<string>",
    "ad_type": "<string>",
    "headlines": [
      {
        "text": "<string>",
        "type": "<string>"
      }
    ],
    "descriptions": [
      {
        "text": "<string>",
        "type": "<string>"
      }
    ],
    "status": "<string>",
    "ad_group_id": "<string>",
    "ad_group_name": "<string>",
    "campaign_id": "<string>",
    "campaign_name": "<string>",
    "metrics": {
      "impressions": 123,
      "ctr": 123,
      "average_cpc": 123,
      "conversion_rate": 123,
      "conversions": 123,
      "cost_per_conversion": 123,
      "clicks": 123,
      "cost": 123
    },
    "final_url": "<string>"
  }
]

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

customer_id
string
required
login_customer_id
integer | null
start_date
string
end_date
string
ad_group_id
integer | null
ad_id
integer | null
limit
integer
default:20
token_id
integer | null

Response

Successful Response

ad_id
string
required
ad_type
string
required
headlines
AdAsset · object[]
required
descriptions
AdAsset · object[]
required
status
string
required
ad_group_id
string
required
ad_group_name
string
required
campaign_id
string
required
campaign_name
string
required
metrics
AdMetrics · object
required

Metrics associated with an ad

final_url
string | null