Skip to main content
Google AdsVersion: v3

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.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:loc_abc123
typestring

Integration type

Available optionsAD_MANAGERAD_WORDS
Example:AD_MANAGER
conversionTypestring

Conversion action type to filter by

Available optionsUPLOAD_CLICKSUPLOAD_CALLSWEBPAGELEAD_FORM_SUBMITAD_CALL
Example:WEBPAGE
categorystring

Conversion action category to filter by

Available optionsDEFAULTPAGE_VIEWPURCHASESIGNUPLEADDOWNLOADADD_TO_CARTBEGIN_CHECKOUTSUBSCRIBE_PAIDPHONE_CALL_LEADIMPORTED_LEADSUBMIT_LEAD_FORM
Example:PURCHASE
startDatestring

Filter start date

Example:2024-01-01
endDatestring

Filter end date

Example:2024-12-31
limitstring

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.

Example:100
pageTokenstring

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

Example:100

Response

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

oneOf
  • Array items
    • conversion_action_idstringrequired

    Google Ads conversion action id

    Example:7086809727
    conversion_namestringrequired

    Conversion action name

    Example:Offline purchase
    conversion_sourcestringrequired

    Always UPLOAD on this branch

    Example:UPLOAD