Search publishers | MediaContext documentation

{
  "data": [
    {
      "domain": "string",
      "name": "string",
      "rank": 1,
      "countryCode": "string",
      "categories": [
        "string"
      ],
      "managementStatus": "self_managed",
      "ownershipRoles": [
        "parent"
      ],
      "supplyTypes": [
        "string"
      ],
      "headerBidding": true,
      "monetizedBy": "string",
      "technologies": [
        {
          "category": "string",
          "name": "string"
        }
      ],
      "provenance": [
        {
          "source": "string",
          "sourceUpdatedAt": "2024-01-15T09:30:00Z",
          "observedAt": "2024-01-15T09:30:00Z",
          "fetchedAt": "2024-01-15T09:30:00Z"
        }
      ]
    }
  ],
  "page": {
    "offset": 1,
    "limit": 1,
    "total": 1,
    "hasMore": true
  },
  "meta": {
    "datasetId": "string",
    "observedAt": "2024-01-15T09:30:00Z",
    "freshness": "string",
    "warnings": [
      "string"
    ]
  }
}

Requires an authenticated workspace. API keys require read scope and pro entitlement.

Authentication

X-Api-Keystring

mck_ key; explicit key takes precedence over session. Read/export scopes, no writes.

AuthorizationBearer

Clerk session with an active mapped organization and current membership

Query parameters

offsetintegerOptional0-1000000Defaults to 0

limitintegerOptional1-100Defaults to 25

qstringOptional<=200 characters

segmentenumOptional

Allowed values:

managementStatusenumOptional

Allowed values:

ownershipRoleenumOptional

Allowed values:

supplyTypestringOptional<=100 characters

monetizedBystringOptional<=200 characters

tierenumOptional

Allowed values:

headerBiddingenumOptional

Allowed values:

countrystringOptionalformat: "^[A-Z]{2}$"

Resolved headquarters country, ISO 3166-1 alpha-2; not visitor geography

techCategorystringOptional<=100 characters

vendorstringOptional<=200 characters

Response

Success

datalist of objects

pageobject

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error