Back to API documentation

GET /platforms

Get a list of all supported ad platforms and their clickTag formats.

Overview

The /platforms endpoint returns information about all ad platforms supported by Adloom, including their clickTag formats, categories, and platform identifiers. This endpoint requires no authentication and returns metadata about 11 supported ad servers and DSPs.

Request

Endpoint

GET https://adloom.io/api/v1/platforms

Authentication

This endpoint does not require authentication.

Example request

curl -X GET https://adloom.io/api/v1/platforms

Response

Status code

200 OK on success

Response body

A JSON object containing an array of platform objects, total count, and category groupings:

id

Unique platform identifier used in API requests

name

Human-readable platform name

shortName

Abbreviated platform name suitable for UI display

category

Platform category; either ad_server or dsp

clicktagFormat

ClickTag format type for this platform; used to determine auto-fix strategy

totalCount

Total number of supported platforms

categories

Object grouping platform IDs by category:

  • - ad_servers: array of ad server platform IDs
  • - dsps: array of DSP platform IDs

Example response

{
  "platforms": [
    {
      "id": "cm360",
      "name": "Campaign Manager 360",
      "shortName": "CM360",
      "category": "ad_server",
      "clicktagFormat": "cm360"
    },
    {
      "id": "adform",
      "name": "Adform",
      "shortName": "Adform",
      "category": "ad_server",
      "clicktagFormat": "adform"
    },
    {
      "id": "innovid",
      "name": "Innovid (Flashtalking)",
      "shortName": "Innovid",
      "category": "ad_server",
      "clicktagFormat": "innovid"
    },
    {
      "id": "amazon_ad_server",
      "name": "Amazon Ad Server",
      "shortName": "Amazon AS",
      "category": "ad_server",
      "clicktagFormat": "amazon"
    },
    {
      "id": "equativ",
      "name": "Equativ",
      "shortName": "Equativ",
      "category": "ad_server",
      "clicktagFormat": "equativ"
    },
    {
      "id": "dv360",
      "name": "Display & Video 360",
      "shortName": "DV360",
      "category": "dsp",
      "clicktagFormat": "dv360"
    },
    {
      "id": "thetradedesk",
      "name": "The Trade Desk",
      "shortName": "TTD",
      "category": "dsp",
      "clicktagFormat": "generic"
    },
    {
      "id": "amazon_dsp",
      "name": "Amazon DSP",
      "shortName": "Amazon DSP",
      "category": "dsp",
      "clicktagFormat": "generic"
    },
    {
      "id": "yahoo_dsp",
      "name": "Yahoo DSP",
      "shortName": "Yahoo DSP",
      "category": "dsp",
      "clicktagFormat": "generic"
    },
    {
      "id": "stackadapt",
      "name": "StackAdapt",
      "shortName": "StackAdapt",
      "category": "dsp",
      "clicktagFormat": "generic"
    },
    {
      "id": "mediasmart",
      "name": "Mediasmart",
      "shortName": "Mediasmart",
      "category": "dsp",
      "clicktagFormat": "generic"
    }
  ],
  "totalCount": 11,
  "categories": {
    "ad_servers": ["cm360", "innovid", "amazon_ad_server", "adform", "equativ"],
    "dsps": ["dv360", "thetradedesk", "amazon_dsp", "yahoo_dsp", "stackadapt", "mediasmart"]
  }
}

Supported platforms

Adloom supports 11 platforms across 2 categories: 5 ad servers and 6 DSPs.

Ad servers

Campaign Manager 360

ID: cm360 | Format: cm360

Innovid (Flashtalking)

ID: innovid | Format: innovid

Amazon Ad Server

ID: amazon_ad_server | Format: amazon

Adform

ID: adform | Format: adform

Equativ

ID: equativ | Format: equativ

DSPs (Demand-Side Platforms)

Display & Video 360

ID: dv360 | Format: dv360

The Trade Desk

ID: thetradedesk | Format: generic

Amazon DSP

ID: amazon_dsp | Format: generic

Yahoo DSP

ID: yahoo_dsp | Format: generic

StackAdapt

ID: stackadapt | Format: generic

Mediasmart

ID: mediasmart | Format: generic

Using platform data

Specifying target platforms

Use the platform ID when specifying a target_platform in /scan or /fix requests:

curl -X POST https://adloom.io/api/v1/scan \
  -H "X-API-Key: adl_your_api_key_here" \
  -F "file=@creative.zip" \
  -F "target_platform=dv360"

Building a platform selector

Use the /platforms endpoint to populate a dropdown or selection interface in your application. The categories object groups platforms by type, and shortName is ideal for compact UI displays.

ClickTag formats

The clicktagFormat field indicates how Adloom detects and auto-fixes clickTag implementations:

cm360

Campaign Manager 360 uses direct clickTag macro substitution

dv360

Display & Video 360 uses Google Enabler library with specific syntax

amazon

Amazon Ad Server uses proprietary click handlers

adform

Adform provides click tracking through the Adform global object

innovid

Innovid (Flashtalking) uses specific click tracking mechanisms

equativ

Equativ ad server uses custom clickTag implementation

generic

Standard clickTag variable, commonly used by DSPs and custom implementations

Error handling

The /platforms endpoint is public and should rarely return errors. In case of server issues, it returns HTTP 500 with an error message.