Skip to content

AscendX API (v1.9)

Download OpenAPI description
asx-api.json
asx-api.yaml
Languages
Servers
Mock server
https://developers.ascendxnow.com/_mock/asx-docs/asx-api/
Generated server url
https://console-stg.ascendxnow.com/

Bidder Network API

APIs related to bidder networks

Operations

Location API

APIs to query countries, states, etc

Operations

Placement API

APIs related to placement

Operations

Get placements by site ID

Request

Security
oauth2
Query
siteIdstringrequired
curl -i -X GET \
  'https://developers.ascendxnow.com/_mock/asx-docs/asx-api/api/external/v1/placement?siteId=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Body
emptyboolean
partialObjectboolean
property name*anyadditional property
Response
{
  "empty": true,
  "partialObject": true,
  "property1": null,
  "property2": null
}

Create placement

Request

Security
oauth2
Bodyapplication/jsonrequired
adunitIdsArray of integers(int64)
descriptionstring
namestring
placementIdstring
siteIdstring
supportedAdFormatsArray of strings
Items Enum"banner""interstitial""rewarded""DISPLAY""VIDEO""NATIVE"
supportedSizesArray of objects(AdunitSize)
curl -i -X POST \
  https://developers.ascendxnow.com/_mock/asx-docs/asx-api/api/external/v1/placement \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "adunitIds": [
      0
    ],
    "description": "string",
    "name": "string",
    "placementId": "string",
    "siteId": "string",
    "supportedAdFormats": [
      "banner"
    ],
    "supportedSizes": [
      {
        "height": 0,
        "width": 0
      }
    ]
  }'

Responses

OK

Body
emptyboolean
partialObjectboolean
property name*anyadditional property
Response
{
  "empty": true,
  "partialObject": true,
  "property1": null,
  "property2": null
}

Deactivate placement

Request

Security
oauth2
Query
placementIdstringrequired
curl -i -X PUT \
  'https://developers.ascendxnow.com/_mock/asx-docs/asx-api/api/external/v1/placement/deactivate?placementId=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Body
emptyboolean
partialObjectboolean
property name*anyadditional property
Response
{
  "empty": true,
  "partialObject": true,
  "property1": null,
  "property2": null
}

Update placement info

Request

Security
oauth2
Bodyapplication/jsonrequired
descriptionstring
namestring
placementIdstring
curl -i -X PUT \
  https://developers.ascendxnow.com/_mock/asx-docs/asx-api/api/external/v1/placement/info \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": "string",
    "name": "string",
    "placementId": "string"
  }'

Responses

OK

Body
emptyboolean
partialObjectboolean
property name*anyadditional property
Response
{
  "empty": true,
  "partialObject": true,
  "property1": null,
  "property2": null
}

Reactivate placement

Request

Security
oauth2
Query
placementIdstringrequired
curl -i -X PUT \
  'https://developers.ascendxnow.com/_mock/asx-docs/asx-api/api/external/v1/placement/reactivate?placementId=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Body
emptyboolean
partialObjectboolean
property name*anyadditional property
Response
{
  "empty": true,
  "partialObject": true,
  "property1": null,
  "property2": null
}

Get placement by placement ID

Request

Security
oauth2
Path
placementIdstringrequired
curl -i -X GET \
  'https://developers.ascendxnow.com/_mock/asx-docs/asx-api/api/external/v1/placement/{placementId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

OK

Body
emptyboolean
partialObjectboolean
property name*anyadditional property
Response
{
  "empty": true,
  "partialObject": true,
  "property1": null,
  "property2": null
}

Analytics API

APIs to get performance metrics

Operations

Partner API

APIs related to partners

Operations

Site API

APIs related to sites.

Operations

Account API

APIs related to account

Operations

Mobile App API

APIs to query mobile app details

Operations

App API

APIs related to apps

Operations

Adunit API

APIs related to adunits

Operations