Meta advertiser's ads API

curl -G "https://api.dataxapi.com/v1/meta/advertisers/ads/list" \
  --data-urlencode "id=182162001806727" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

{
  "code": "ok",
  "request_id": "e668eb1d-037c-4aa8-a619-d97577b4018d",
  "data": {
    "items": [
      {
        "id": "1366273623732556",
        "url": "https://www.facebook.com/ads/library/?id=1366273623732556",
        "format": "image",
        "title": "Weekend hiking essentials, 20% off this week only",
        "text": "Weekend hiking essentials, 20% off this week only",
        "landing_url": "https://www.northside-roasters.com/new?utm_source=meta",
        "advertiser": {
          "id": "163608278941038",
          "name": "Northside Coffee",
          "url": "https://www.facebook.com/profile.php?id=163608278941038",
          "avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/442435085_118101354893229_n.jpg"
        },
        "images": [
          "https://scontent.xx.fbcdn.net/v/t39.35426-6/457089164_132879709605097_n.jpg",
          "https://scontent.xx.fbcdn.net/v/t39.35426-6/495655475_123700917496493_n.jpg",
          // … 4 more
        ],
        "first_shown_at": "2025-04-07T07:00:00.000Z",
        "last_shown_at": "2026-10-12T07:00:00.000Z"
      },
      // … 29 more
    ]
  },
  "page": {
    "next_cursor": "c1.TODjSo-a2u-2vYIvOrK_MLKKlXvkiTJkQul7_7Fg",
    "cursor_expires_at": "2026-10-12T22:44:28.000Z",
    "has_more": true,
    "returned": 30
  },
  "warnings": [],
  "meta": {
    "capability": "meta.advertisers.ads.list",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:44:28.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

From a response recorded 2026-10-12 21:44 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

Size as sent: 97.2 KB in the standard view (11.8 KB compact, 222.5 KB full).

{
  "code": "ok",
  "request_id": "0448d31a-da7f-4c38-998b-d53f348bb6c7",
  "data": { "items": [] },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 0
  },
  "warnings": [],
  "meta": {
    "capability": "meta.advertisers.ads.list",
    "result_status": "empty",
    "fetched_at": "2026-10-12T21:44:31.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

From a response recorded 2026-10-12 21:44 UTC. The request ID and balance are made up.

Size as sent: 408 B in the standard view (408 B compact, 408 B full).

curl -G "https://api.dataxapi.com/v1/meta/advertisers/ads/list" \
  --data-urlencode "id=182162001806727" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.meta.advertisers.ads.list(id="182162001806727")
print(result["data"]["items"])

import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.meta.advertisers.ads.list({ id: "182162001806727" });
console.log(result.data.items);

dataxapi call meta.advertisers.ads.list id=182162001806727

{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call meta.advertisers.ads.list.