Get Campaign By Id
Endpoint to retrieve specific campaign by Campaign ID.
It is expected to use at Campaign Page.
Authentication
Topsort’s APIs are authenticated via bearer tokens. Requests must include an authorization header containing your private API key.
Don't have an API key yet? Learn how to generate one.
The header containing a private API key. Format this header as follows:
Authorization: Bearer <YOUR-API-KEY>
Path Parameters
object
The ID of the campaign.
The ID of the campaign.
Responses
Successful Response
The campaign model.
object
The ad format of the campaign. Can be listing or banner.
The amount of active bids associated with this campaign.
The budget assigned to the campaign.
object
The amount of money in the budget in minor units of currency according to ISO 4217.
The amount carried over from the last period.
The remaining amount of the budget.
The used amount of the budget.
Deprecated. This field is always null. For behavioral data use reporting service.
Deprecated. This field is always null. For behavioral data use reporting service.
The ID of the campaign.
The bidding method for the campaign.
How campaigns are going to be charged, by click or by per mille impressions
When was this campaign created.
The end date of the campaign.
Daily price for an exclusive campaign, can only be set if a campaign is exclusive
The ID of the vendor. Deprecated. Use vendor_id instead.
Whether this campaign is active.
Whether this campaign is “smart”.
Whether this is a promoted shop campaign.
The ID of the marketplace.
The name of the campaign.
object
The assets for the banner campaign, if adFormat
is banner
.
Represents the banner resource file, it’s location, mimetype, dimensions and size.
object
The mime type of the asset.
The width and height of an asset.
object
The height of the image.
The width of the image.
The file size of the asset, in bytes.
The url where the asset is located.
The targeted device for this campaign, if adFormat
is banner
.
The external slot id provided by the marketplace.
object
The starting date of the campaign.
Represents the review status of a banner campaign.
The ID of the user who reviewed the campaign. If it’s null
and the status is not "pending"
then it means this campaign has autoapproval status.
The target return on ad spend (ROAS) for this campaign. This is only applicable for autobidding listing campaigns.
The ID of the vendor.
The uuid of the wallet to be used with this campaign.
Validation Error