REST API · Bridge

Get bridge daily stats

The Bridge's Daily tab: per platform and per day, the numbers of every creative bridged from a Meta ad account

GEThttps://api.apogee.ad/api/v1/bridged-ads/daily-stats

Scope: read Pro and Scale plans Credits: Free*

What it does

Day by day over since → until (366 days at most): spend, revenue, ROAS, impressions, link clicks and purchases summed over the Meta source ads and, separately, over their TikTok and Snapchat copies, with each platform's totals, status and currency. Platforms are never summed together.

Request

GET /bridged-ads/daily-stats on https://api.apogee.ad/api/v1.

Query parameters

source_ad_account_id string query required

The Meta ad account the ads were bridged from (act_…)

Matches ^(act_)?\d{1,32}$
since string query required

First day, YYYY-MM-DD

Matches ^\d{4}-\d{2}-\d{2}$
until string query required

Last day, YYYY-MM-DD

Matches ^\d{4}-\d{2}-\d{2}$

Headers

Authorization string header required

Bearer apk_…: an API key with the scope of this route.

Response

200.

range object
Fields (2)
- since string
- until string
platforms object
Fields (3)
- meta object
  Fields (6)
  - status string
    
    One of ok, no_target, not_connected, error
  - currency string or null
  - totals object or null
    
    Fields (6)
    
    spend number or null
    
    revenue number or null
    
    impressions number or null
    
    link_clicks number or null
    
    purchases number or null
    
    roas number or null
  - days array of objects or null
    
    Every day of the range (zeros when nothing delivered); null when status is not ok
    
    Fields of each item (7)
    
    date string
    
    spend number or null
    
    revenue number or null
    
    impressions number or null
    
    link_clicks number or null
    
    purchases number or null
    
    roas number or null
  - hint string or null
  - error string or null
- tiktok object
  Fields (6)
  - status string
    
    One of ok, no_target, not_connected, error
  - currency string or null
  - totals object or null
    
    Fields (6)
    
    spend number or null
    
    revenue number or null
    
    impressions number or null
    
    link_clicks number or null
    
    purchases number or null
    
    roas number or null
  - days array of objects or null
    
    Every day of the range (zeros when nothing delivered); null when status is not ok
    
    Fields of each item (7)
    
    date string
    
    spend number or null
    
    revenue number or null
    
    impressions number or null
    
    link_clicks number or null
    
    purchases number or null
    
    roas number or null
  - hint string or null
  - error string or null
- snapchat object
  Fields (6)
  - status string
    
    One of ok, no_target, not_connected, error
  - currency string or null
  - totals object or null
    
    Fields (6)
    
    spend number or null
    
    revenue number or null
    
    impressions number or null
    
    link_clicks number or null
    
    purchases number or null
    
    roas number or null
  - days array of objects or null
    
    Every day of the range (zeros when nothing delivered); null when status is not ok
    
    Fields of each item (7)
    
    date string
    
    spend number or null
    
    revenue number or null
    
    impressions number or null
    
    link_clicks number or null
    
    purchases number or null
    
    roas number or null
  - hint string or null
  - error string or null
source_ad_account_id string

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Status	Possible codes
400 Bad request	`idempotency_key_required`, `not_supported`, `request_refused`, `validation_failed`
401 Unauthorized	`invalid_api_key`
403 Forbidden	`account_not_connected`, `forbidden`, `insufficient_scope`, `meta_permission_denied`, `platform_permission_denied`, `upgrade_required`
404 Not found	`not_found`
412 Precondition failed	`drive_not_connected`, `meta_not_connected`, `platform_not_connected`
429 Too many requests	`daily_read_cap`, `meta_rate_limited`, `platform_rate_limited`, `quota_exceeded`, `rate_limited`
500 Internal server error	`internal_error`
502 Bad gateway	`drive_error`, `launch_failed`, `meta_error`, `platform_error`, `upstream_error`

Example

With your key in APOGEE_API_KEY (create one):

Request

curl 'https://api.apogee.ad/api/v1/bridged-ads/daily-stats?source_ad_account_id=act_1234567890&since=2026-10-01&until=2026-10-21' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

Response 200 (shape)

{
  "range": {
    "since": "2026-10-01",
    "until": "2026-10-21"
  },
  "source_ad_account_id": "120200000000000001",
  "platforms": {
    "meta": {
      "status": "ok",
      "currency": "EUR",
      "totals": {
        "spend": 125.4,
        "revenue": 612.5,
        "impressions": 18250,
        "link_clicks": 1,
        "purchases": 9,
        "roas": 4.88
      },
      "days": [
        {
          "date": "2026-10-21",
          "spend": 125.4,
          "revenue": 612.5,
          "impressions": 18250,
          "link_clicks": 1,
          "purchases": 9,
          "roas": 4.88
        }
      ],
      "hint": "120200000000000001",
      "error": "120200000000000001"
    },
    "tiktok": {
      "status": "ok",
      "currency": "EUR",
      "totals": {
        "spend": 125.4,
        "revenue": 612.5,
        "impressions": 18250,
        "link_clicks": 1,
        "purchases": 9,
        "roas": 4.88
      },
      "days": [
        {
          "date": "2026-10-21",
          "spend": 125.4,
          "revenue": 612.5,
          "impressions": 18250,
          "link_clicks": 1,
          "purchases": 9,
          "roas": 4.88
        }
      ],
      "hint": "120200000000000001",
      "error": "120200000000000001"
    },
    "snapchat": {
      "status": "ok",
      "currency": "EUR",
      "totals": {
        "spend": 125.4,
        "revenue": 612.5,
        "impressions": 18250,
        "link_clicks": 1,
        "purchases": 9,
        "roas": 4.88
      },
      "days": [
        {
          "date": "2026-10-21",
          "spend": 125.4,
          "revenue": 612.5,
          "impressions": 18250,
          "link_clicks": 1,
          "purchases": 9,
          "roas": 4.88
        }
      ],
      "hint": "120200000000000001",
      "error": "120200000000000001"
    }
  }
}

Access and cost

Plans	Pro and Scale.
Scope	`read` (scopes).
Credits	Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A request that fails costs nothing, a replayed one neither (credits).
Rate limit	Read: 600 per 15 minutes on Pro, 1,200 on Scale (rate limits).
Meta budget	Reads Meta: spends 1 unit of the account's Meta budget (1,800 per 15 minutes, 900 per ad account).
Daily cap	Counts 1 unit toward the 2,000 units one API key can use in 24 hours.

In the MCP

An AI assistant does the same with this tool of the MCP server:

get_bridge_daily_stats: The Bridge's Daily tab: day by day, per platform, the spend, revenue, ROAS, impressions, link clicks and purchases of every creative bridged from a Meta ad account (366 days at most). Platforms are never added up.

Create bridge transfer: POST /bridge-transfers
Confirm bridge transfer: POST /bridge-transfers/{id}/confirm
Get bridge transfer: GET /bridge-transfers/{id}
List bridged ads: GET /bridged-ads
Get bridge stats: GET /bridged-ads/stats

What it does

Request

Query parameters

Headers

Response

Errors

Example

Access and cost

In the MCP

Related operations