REST API reference

Base URL https://app.lazyads.ai/api/v1. Every request requires Authorization: Bearer <api_key>. Download the full machine-readable spec from openapi.json .

Campaigns

GET/campaignsList all campaigns with latest metrics
POST/campaignsCreate a campaign
GET/campaigns/{id}Get a campaign with ad sets and ads
POST/campaigns/{id}/pausePause a campaign (syncs to platform)
POST/campaigns/{id}/resumeResume a campaign (syncs to platform)

Performance & creatives

GET/performancePerformance snapshots, filterable by campaign and date range
GET/creativesCreative library with predicted performance scores

Competitors

GET/competitorsList tracked competitors
POST/competitorsAdd a competitor to track
GET/competitors/adsSearch the Meta Ad Library

Account & AI

GET/connectionsList connected ad platform accounts
GET/notificationsRecent notifications and AI actions
POST/chatChat with the LazyAds AI assistant
POST/eventsIngest a first-party conversion event (CAPI)

Errors

Errors return a JSON body with a stable code and the HTTP status:

{
  "error": {
    "message": "Invalid or revoked API key",
    "code": "INVALID_KEY",
    "status": 401
  }
}