LinkedIn ads

curl "https://fliok.com/api/v1/linkedin/ads?days=30" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

// 200 OK — read from Fliok's 6-hourly sync; money in minor units (paise)
{
  "linkedin": {
    "days": 30,
    "since": "2026-09-30",
    "until": "2026-10-29",
    "campaigns": [
      {
        "id": "381944012",
        "urn": "urn:li:sponsoredCampaign:381944012",
        "name": "Diwali offer — founders, Mumbai",
        "status": "ACTIVE",
        "accountUrn": "urn:li:sponsoredAccount:512830044",
        "accountName": "Asha Sarees",
        "currency": "INR",
        "spendMinor": 1845000,
        "impressions": 41210,
        "clicks": 612,
        "ctr": 0.0149,
        "leads": 37,
        "conversions": 9,
        "costPerLeadMinor": 49865
      }
    ],
    "totals": [{ "currency": "INR", "spendMinor": 1845000, "impressions": 41210, "clicks": 612, "leads": 37, "conversions": 9 }],
    "crm": { "leads": 41, "won": 6 },
    "syncedAt": "2026-10-29T06:00:12.000Z",
    "running": false,
    "accounts": 1
  },
  "canManage": true,
  "planLocked": false
}

curl "https://fliok.com/api/v1/linkedin/ad-library?kind=ads&keyword=saree&country=IN&days=30" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

// 200 OK — kept an hour per search; ?start= takes "next" for the next page
{
  "kind": "ads",
  "rows": [
    {
      "id": "601123987",
      "url": "https://www.linkedin.com/ad-library/detail/601123987",
      "advertiserName": "Kanchi Weaves",
      "payer": "Kanchi Weaves Pvt Ltd",
      "format": "SPONSORED_STATUS_UPDATE",
      "formatLabel": "Single image",
      "firstSeen": "2026-10-02T00:00:00.000Z",
      "lastSeen": "2026-10-27T00:00:00.000Z",
      "countries": [{ "country": "IN", "share": 1 }]
    }
  ],
  "start": 0,
  "count": 1,
  "total": 1,
  "hasMore": false,
  "next": 1,
  "days": 30
}

curl -X POST "https://fliok.com/api/v1/linkedin/ads/message-ads" \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Idempotency-Key: diwali-founders-1" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "conversation",
    "account": "urn:li:sponsoredAccount:512830044",
    "name": "Diwali offer — founders, Mumbai",
    "subject": "A Diwali gift for your team",
    "opening": "Hi! We make handwoven sarees for corporate gifting. Want the Diwali catalogue?",
    "buttons": [{ "text": "Chat on WhatsApp", "action": "whatsapp", "message": "Hi, please send the Diwali catalogue" }],
    "locations": ["urn:li:geo:106164952"],
    "playbook": "Share the catalogue, ask team size and delivery date, offer a call.",
    "locale": "en_US",
    "dailyBudget": "1500",
    "startAt": 1761955200000,
    "endAt": null,
    "notPolitical": true
  }'

// 200 OK — a DRAFT: nothing runs until you launch it in Campaign Manager
{
  "ok": true,
  "kind": "conversation",
  "name": "Diwali offer — founders, Mumbai",
  "accountUrn": "urn:li:sponsoredAccount:512830044",
  "accountName": "Asha Sarees",
  "created": {
    "campaignGroupUrn": "urn:li:sponsoredCampaignGroup:701244",
    "campaignUrn": "urn:li:sponsoredCampaign:381990311",
    "conversationUrn": "urn:li:sponsoredConversation:55120",
    "inMailContentUrn": null,
    "creativeUrn": "urn:li:sponsoredCreative:902211"
  },
  "campaignManagerUrl": "https://www.linkedin.com/campaignmanager/accounts/512830044/campaigns/381990311",
  "startAt": 1761955200000,
  "outreach": { "id": "0b6c8f3e-2f1a-4d7e-9c55-1a2b3c4d5e6f", "aiOn": true }
}

# 1. Is it eligible, and what may it cost? (spends nothing)
curl -X POST "https://fliok.com/api/v1/linkedin/boost/7d0e5a52-6b1f-4c1e-8a3e-0c9d2f4b7a10/init" \
  -H "Authorization: Bearer wa_YOUR_SPEND_KEY" -H "Content-Type: application/json" -d '{}'

# 2. Preview with your total budget (spends nothing)
curl -X POST "https://fliok.com/api/v1/linkedin/boost/7d0e5a52-6b1f-4c1e-8a3e-0c9d2f4b7a10/preview" \
  -H "Authorization: Bearer wa_YOUR_SPEND_KEY" -H "Content-Type: application/json" \
  -d '{ "goal": "ENGAGEMENT", "schedule": { "start": 1761955200000, "end": 1762560000000 }, "amount": "5000" }'

# 3. Start it: echo the preview exactly. This spends.
curl -X POST "https://fliok.com/api/v1/linkedin/boost/7d0e5a52-6b1f-4c1e-8a3e-0c9d2f4b7a10" \
  -H "Authorization: Bearer wa_YOUR_SPEND_KEY" -H "Idempotency-Key: boost-diwali-1" -H "Content-Type: application/json" \
  -d '{ "confirmSpend": true, "goal": "ENGAGEMENT", "schedule": { "start": 1761955200000, "end": 1762560000000 }, "amount": "5000", "currencyCode": "INR" }'

// 1 → 200 OK
{ "billingConfigured": true, "billingUrl": null, "currencyCode": "INR", "goals": ["ENGAGEMENT", "WEBSITE_VISIT"], "defaultGoal": "ENGAGEMENT",
  "defaultSchedule": { "start": 1761955200000, "end": 1762560000000 }, "maxTotalBudget": { "amount": "50000", "currencyCode": "INR" } }

// 2 → 200 OK
{ "currencyCode": "INR", "audienceName": "Followers and people like them", "audienceCount": 184000,
  "forecast": { "impressions": { "low": 9800, "high": 14200 } }, "suggestedBudgets": [{ "amount": { "amount": "4000", "currencyCode": "INR" } }],
  "maxTotalBudget": { "amount": "50000", "currencyCode": "INR" }, "minDailyBudget": { "amount": "100", "currencyCode": "INR" },
  "chosen": { "goal": "ENGAGEMENT", "schedule": { "start": 1761955200000, "end": 1762560000000 }, "budget": { "amount": "5000", "currencyCode": "INR" } } }

// 3 → 200 OK (a key without ads:spend gets 403 insufficient_scope, required "ads:spend")
{ "ok": true, "status": "IN_REVIEW" }

curl -X POST "https://fliok.com/api/v1/linkedin/audiences" \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Idempotency-Key: aud-hot-leads" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Hot leads — Mumbai", "adAccountUrn": "urn:li:sponsoredAccount:512830044", "tags": ["hot", "mumbai"] }'

// 201 Created — hashed emails go to LinkedIn from the next hourly sync
{
  "audience": {
    "id": "c1f0a9e2-7b3d-4e55-8a10-9d8e7f6a5b4c",
    "name": "Hot leads — Mumbai",
    "adAccountUrn": "urn:li:sponsoredAccount:512830044",
    "tags": ["hot", "mumbai"],
    "stageIds": []
  }
}