Example API Requests

Introduction

In addition to receiving Pivot Reports (described in the following guide: AIO API — Pivot Report Endpoint), you can perform other actions via the API. This guide includes several examples.

Before working with the API, make sure you have an API token, which can be requested from our support team. The token inherits the role and permissions of the AIO user it was generated for. For example, if the user does not have access to Campaigns, API requests related to Campaigns will not be available for that token.

You can inspect requests in DevTools → Network → Data and reuse them by adding your API token as a query parameter (?token=xxx). Please note that these requests are not part of the public API and may change without notice.

Pivot Report Request

For more details, check AIO API — Pivot Report Endpoint.

curl --location 'https://app.aio.tech/api/v1/pivot-report/data?token=XXX' \
--header 'Content-Type: application/json' \
--data '{
"dates": [
"2026-04-01 00:00:00",
"2026-04-31 23:59:59"
],
"back_fix_attribution": false,
"event_time_attribution": false,
"hide_bots": true,
"hide_empty_metrics": true,
"hide_trash": true,
"conditions": [],
"definitions": [
{"key": "campaign_owner_uuid"},
{"key": "location_country_code"}
]
}'

Get Table Requests

Get Domains:

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\\Domains": {
"table": "MTK\\Domains",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Get Servers

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\Settings\Servers": {
"table": "MTK\Settings\Servers",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Get DNS Providers

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\Settings\DnsProviders": {
"table": "MTK\Settings\DnsProviders",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Get Landings

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\\Landers": {
"table": "MTK\\Landers",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "updated_at",
"sort_direction": "desc",
"analytics_position": 1,
"filters": [],
"dates": [
"2025-08-25 00:00:00",
"2025-08-25 23:59:59",
"Europe/Moscow"
],
"hide_empty_metrics": false,
"event_time_attribution": false,
"metric_filters": [],
"metric_definition": null
}
}
}

Get Users

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"MTK\Settings\Users": {
"table": "MTK\Settings\Users",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Get Tags

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
"request": {
"Settings\\Tags": {
"table": "Settings\\Tags",
"page": 1,
"limit": 100,
"search": "",
"sort_key": "",
"sort_direction": "asc",
"analytics_position": 1,
"filters": [],
"dates": [],
"hide_empty_metrics": true,
"hide_bots": true,
"unwrap_tree": false,
"hide_trash": true,
"event_time_attribution": false,
"back_fix_attribution": false,
"metric_filters": [],
"metric_definition": null,
"metric_definitions": []
}
}
}

Get Visits

POST https://app.aio.tech/api/v1/tables/data?token=XXX
{
    "request": {
        "MTK\\Visits": {
            "table": "MTK\\Visits",
            "page": 1,
            "limit": 100,
            "search": "",
            "sort_key": "",
            "sort_direction": "asc",
            "analytics_position": 1,
            "filters": [],
            "dates": [
                "2026-04-08 00:00:00",
                "2026-04-08 23:59:59",
                "Africa/Addis_Ababa"
            ],
            "hide_empty_metrics": false,
            "hide_bots": true,
            "unwrap_tree": false,
            "hide_trash": true,
            "event_time_attribution": false,
            "back_fix_attribution": false,
            "metric_filters": [],
            "metric_definition": null,
            "metric_definitions": []
        }
    }
}

Actions

Buy a New Domain

Use this option to purchase domains in AIO.

curl --location 'https://app.aio.tech/api/v1/actions/process?token=xxx' \
--header 'Content-Type: application/json' \
--data '{
    "action": "Domain\\Create",
    "repository": "Eloquent\\DomainRepository",
    "arguments": {
        "domain_provider_uuid": "XXX" // uuid of domain provider
        "domain_url": "testdomain.com", // url
        "server_uuid": "XXX" // uuid of server to which domain is pointed ( a record )
        "dns_provider_uuid": "XXX", // uuid of dns provider
        "monitoring_user_uuid": "XXX", // uuid of user who will receive notifications
        "settings": "{\"robots\":{\"allow\":false}}"
    }
}'

Add a New Manual Domain

Use this option for domains purchased outside AIO.

POST https://app.aio.tech/api/v1/actions/process?token=XXX
{
"action": "Domain\\CreateManually",
"repository": "Eloquent\\DomainRepository",
"arguments": {
"domain_url": "testdomain.com", // url
"server_uuids": [
"XXX" // uuid of server to which domain is pointed ( a record )
],
"dns_provider_uuid": "XXX", // uuid of dns provider
"monitoring_user_uuid": "XXX", // uuid of user who will receive notifications
"settings": "{\"robots\":{\"allow\":false}}" // generate robots.txt or not
}
}

Update Costs

POST https://app.aio.tech/api/v1/actions/process?token=XXX

{
  "action" : "Campaign\UpdateCosts",
  "repository" : "MassiveEloquent\CampaignRepository",
  "uuids" : ["CAMPAIGN_UUID"], // array of campaign uuids
  "arguments" : {
    "from" : "2025-03-17 00:00:00", // from data
    "to" : "2025-03-17 23:59:59", // to date
    "timezone" : "Africa/Abidjan", // timezone
    "value" : 100, // 100$ (USD)
    "is_cpc" : false,
    "field_uuid" : "FIELD_UUID", // uuid of required field
    "field_value" : "FIELD_VALUE" // value of required field
  }
}