Get conversions

GET 
/ad-publishing/google/conversions

Retrieve Google Ads conversion actions for a location. The response shape is selected by type. When type is AD_MANAGER: without limit a plain array of full conversion actions, and with limit (max 100, default 100) a paginated { conversions, paging } envelope — pass pageToken (from paging.next) for the next batch. When type is omitted or AD_WORDS, a different, minimal snake_case projection is returned and limit, pageToken, startDate, endDate, conversionType and category are all ignored.

Request

Version stringrequired

API Version

Available optionsv3

locationId stringrequired

Location identifier

type string

Integration type

Available optionsAD_MANAGERAD_WORDS

conversionType string

Conversion action type to filter by

Available optionsUPLOAD_CLICKSUPLOAD_CALLSWEBPAGELEAD_FORM_SUBMIT

category string

Conversion action category to filter by

Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM

startDate string

Filter start date

endDate string

Filter end date

limit string

Page size for a paginated fetch (max 100, defaults to 100). When set, the response is a { conversions, paging } envelope instead of a plain array. Applies to AD_MANAGER type only.

pageToken string

Opaque cursor for the next batch, taken from the previous response paging.next

application/json

Minimal array when type is omitted/AD_WORDS, a full array for AD_MANAGER, or a { conversions, paging } envelope for AD_MANAGER with limit

application/json

Schema

Schema

oneOf
• object[]
• object[]
• PaginatedGoogleConversionsDTO
Array [
conversion_action_idstringrequired
Google Ads conversion action id
conversion_namestringrequired
Conversion action name
conversion_sourcestringrequired
Always UPLOAD on this branch
]

Example (auto)

[
  {
    "conversion_action_id": "7086809727",
    "conversion_name": "Offline purchase",
    "conversion_source": "UPLOAD"
  }
]