curl \
-H "Authorization: Bearer API_KEY" \
-X GET "https://api.ayrshare.com/api/ads/facebook/insights?level=campaign&ids=120200000000000001&startDate=2026-09-01&endDate=2026-09-02"

const API_KEY = "API_KEY";
const params = new URLSearchParams({
  level: "campaign",
  ids: "120200000000000001",
  startDate: "2026-09-01",
  endDate: "2026-09-02",
});

fetch(`https://api.ayrshare.com/api/ads/facebook/insights?${params}`, {
  method: "GET",
  headers: { Authorization: `Bearer ${API_KEY}` },
})
  .then((res) => res.json())
  .then((json) => console.log(json))
  .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}
params = {
    'level': 'campaign',
    'ids': '120200000000000001',
    'startDate': '2026-09-01',
    'endDate': '2026-09-02',
}

r = requests.get('https://api.ayrshare.com/api/ads/facebook/insights', headers=headers, params=params)

print(r.json())

{
  "status": "success",
  "platform": "facebook",
  "level": "campaign",
  "startDate": "2026-09-01",
  "endDate": "2026-09-02",
  "insights": [
    {
      "date": "2026-09-01",
      "level": "campaign",
      "id": "120200000000000001",
      "currency": "USD",
      "spend": 12.34,
      "impressions": 4000,
      "reach": 3100,
      "clicks": 80,
      "cpm": 3.085,
      "cpc": 0.15425,
      "ctr": 2,
      "actions": [
        { "type": "link_click", "value": 75 },
        { "type": "omni_purchase", "value": 3 }
      ],
      "conversionValue": 89.97
    }
  ],
  "count": 1,
  "nextCursor": null
}

{
  "status": "success",
  "platform": "facebook",
  "level": "ad",
  "startDate": "2026-09-01",
  "endDate": "2026-09-01",
  "insights": [
    {
      "date": "2026-09-01",
      "level": "ad",
      "id": "120210000000000001",
      "age": "25-34",
      "gender": "female",
      "currency": "EUR",
      "spend": 1.5,
      "impressions": 300
    },
    {
      "date": "2026-09-01",
      "level": "ad",
      "id": "120210000000000001",
      "age": "25-34",
      "gender": "male",
      "currency": "EUR",
      "spend": 1,
      "impressions": 200
    }
  ],
  "count": 2,
  "nextCursor": null
}

{
  "action": "ads",
  "status": "error",
  "code": 400,
  "message": "The ad is not found or not authorized."
}