Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$3 / 1k ads Scrape Facebook/Meta Ad Library — see what ads any brand is currently running, with creative copy, CTA, and dates.

​
Endpoint

POST /api/v1/agents/facebook/ads-library/run

​
Parameters

​
urls
array
required
List · Facebook page URLs (e.g. facebook.com/nike) or Ad Library URLs. One per line.
​
maxResults
integer
default:50
Number · Ads per page. Use 0 for all.
​
activeStatus
string
default:"active"
Dropdown · Filter by ad status.Options: active, inactive, allLegend: active = Active only, inactive = Inactive only, all = All
​
includeAboutPage
boolean
default:false
Toggle · Pull about-page info for each unique advertiser.
​
isDetailsPerAd
boolean
default:false
Toggle · Add audience/targeting details to each ad.

​
Response columns

FieldDisplay nameType
pagePagetext
startDateStart Datedatetime
endDateEnd Datedatetime
adTitleAd Titletext
adBodyAd Bodytext
ctaCTAtext
captionCaptiontext
linkUrlLink URLurl
pageLogoPage Logourl

​
Example

curl -X POST https://api.mindcase.co/api/v1/agents/facebook/ads-library/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      "https://www.facebook.com/nike"
    ],
    "maxResults": 50,
    "activeStatus": "active"
  }
}'

​
Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "page": "Nike",
      "startDate": "2025-04-07T07:00:00.000Z",
      "endDate": "2026-05-04T07:00:00.000Z",
      "adTitle": "Nike Run Swift 3 Women's Road Running Shoes, Nike Invincible 3 Women's Road Running Shoes, Nike Dri-FIT Icon Men's Basketball Jersey, Cosmic Unity 3 Basketball Shoes, Nike ACG Polartec \u00ae 'Wolf Tree' W",
      "adBody": "Bring sports more fully into your day with the Nike App., Bring sports more fully into your day with the Nike App., Bring sports more fully into your day with the Nike App., Bring sports more fully into your day with the Nike App., Bring sports more fully into your day with the Nike App., Bring spor",
      "cta": "Install now",
      "caption": "itunes.apple.com",
      "linkUrl": "https://www.nike.com/ph/t/run-swift-3-road-running-shoes-2fHbzp/DR2698-002",
      "pageLogo": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.35426-6/431756959_712871054375981_2401799800446082357_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=WSzP47EYM_EQ7kNvwFpzai6&_nc_oc=Adr0iUt-FAPOiFcyCV0IL-iSGEdI8vEmcsk9NYnmLp6DXaG4_7DsgIiuFB9JU0n9mX4&_nc_zt=14&_nc_ht=scontent-lax3-1.xx&_nc_gid=7wh86EaDokQyFvjLGfc5_w&_nc_ss=72289&oh=00_Af54Z0U1-nPvRND8u3WzsKOnDXPw2OpDQnALe9Cg-B52_Q&oe=69FE9186"
    }
  ]
}