Facebook Ad Library

Company Ads

per_call

Pages through every ad an advertiser has run, with creative text, media, formats, run dates and status. Use it to reverse-engineer a competitor's funnel, spot new offers the day they launch and track creative refresh rates.

What you get

Each call returns up to 30 ads, plus a cursor for the next 30.

Endpoint

GET /v1/facebook-ad-library/company-ads

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

target

required

string

The advertiser's page name as it appears in the Ad Library. Matching is case-sensitive.

limit

optional

integer

Maximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.

cursor

optional

string

Pagination cursor returned by a previous response.

fresh

optional

enum

Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.

One of: true, 1, false, 0

Example request

Live call. Successful calls are charged; failed and empty results are not.

curl

curl "https://fastfetchz.com/v1/facebook-ad-library/company-ads?target=Nike" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "Facebook Ad Library",
    "name": "Company Ads",
    "slug": "company-ads"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "results": [
      {
        "ad_archive_id": "1702938977100376",
        "collation_count": null,
        "collation_id": null,
        "is_active": true,
        "page_id": "15087023444",
        "page_is_deleted": false,
        "snapshot": {
          "branded_content": null,
          "page_id": "15087023444",
          "page_is_deleted": false,
          "page_profile_uri": "https://www.facebook.com/nike/",
          "root_reshared_post": null,
          "byline": null,
          "disclaimer_label": null,
          "page_name": "Nike",
          "page_profile_picture_url": "https://scontent-bos5-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=lHtgbjFLY_EQ7kNvwEXVZs8&_nc_oc=AdoWHLBV6hN2MC39Glub-chXX-CYzOYw-PqIY-FtXWw1kagI_fxDrNh1GEjOwOrTfi4&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQLfQz-nAuFuAxo15XF8ngpNPM8xAdH0l3x0-1gLyn_aIg…",
          "event": null,
          "caption": "itunes.apple.com",
          "cta_text": "Install now",
          "cards": [
            {
              "body": "Bring sports more fully into your day with the Nike App.",
              "cta_type": "INSTALL_MOBILE_APP",
              "caption": "itunes.apple.com",
              "link_description": "₱3,599",
              "link_url": "https://www.nike.com/ph/t/acg-polartec-wolf-tree-mid-rise-trousers-mVbQBn/CV0615-060",
              "title": "Nike ACG Polartec ® 'Wolf Tree' Women's Mid-Rise Trousers",
              "cta_text": "Install Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": [],
              "original_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431748186_289316047369916_1595311644416959995_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=EfYMn16b8_QQ7kNvwFulWnR&_nc_oc=AdqdeVaKMWj3DRdMi9xfjWGDxe3dJMx8c6l3tSkRji4-yDRXMlH7fb4VSHgT8RR0_Z4&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQIug9RyUhKUApGlSgm50JUIyk5i5th0W4SrFDaKG2jZnQ&oe=6AA63E1F",
              "resized_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431748186_289316047369916_1595311644416959995_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=EfYMn16b8_QQ7kNvwFulWnR&_nc_oc=AdqdeVaKMWj3DRdMi9xfjWGDxe3dJMx8c6l3tSkRji4-yDRXMlH7fb4VSHgT8RR0_Z4&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQJOZnvjqOrwqbVUkNyn3tTYq0Xi9UAEfFOUe2mSPQ9M…",
              "watermarked_resized_image_url": ""
            },
            {
              "body": "Bring sports more fully into your day with the Nike App.",
              "cta_type": "INSTALL_MOBILE_APP",
              "caption": "itunes.apple.com",
              "link_description": "₱3,595",
              "link_url": "https://www.nike.com/ph/t/fc-barcelona-2023-24-stadium-fourth-dri-fit-football-shirt-j09wGH/DR5081-729",
              "title": "Nike F.C. Barcelona 2023/24 Stadium Fourth Women's Nike Dri-FIT Football Shirt",
              "cta_text": "Install Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": [],
              "original_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431734766_930233981755195_3984431312184472988_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=iwbAn-MQ_XcQ7kNvwEjRx7Q&_nc_oc=AdosfN46fv_qbSnNSRjhWPdeDNqXcnsunx2ToIFDJu45q7x3iHy3Nt7e7LYYYsofKDo&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQKq3XAgeniEBjLa6TZ1b982OEpXSfQOXZaNhfAkMcizSQ&oe=6AA651AB",
              "resized_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/431734766_930233981755195_3984431312184472988_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=iwbAn-MQ_XcQ7kNvwEjRx7Q&_nc_oc=AdosfN46fv_qbSnNSRjhWPdeDNqXcnsunx2ToIFDJu45q7x3iHy3Nt7e7LYYYsofKDo&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQJwqWAZqM2Cbys68qGsutiIv1Fohu4YrfXaaGS0UMFI…",
              "watermarked_resized_image_url": ""
            }
          ],
          "body": {
            "text": "Bring sports more fully into your day with the Nike App."
          },
          "cta_type": "INSTALL_MOBILE_APP",
          "display_format": "DPA",
          "link_description": "₱3,599",
          "link_url": "http://itunes.apple.com/app/id1095459556",
          "images": [],
          "page_categories": [
            "Sportswear",
            "Product/service"
          ],
          "page_like_count": 39546884,
          "title": "Nike ACG Polartec ® 'Wolf Tree' Women's Mid-Rise Trousers",
          "videos": [],
          "is_reshared": false,
          "extra_links": [],
          "extra_texts": [],
          "extra_images": [],
          "extra_videos": [],
          "country_iso_code": null,
          "brazil_tax_id": null,
          "additional_info": null,
          "ec_certificates": []
        },
        "has_user_reported": false,
        "report_count": null,
        "menu_items": [],
        "state_media_run_label": null,
        "page_name": "Nike",
        "impressions_with_index": {
          "impressions_text": null,
          "impressions_index": -1
        },
        "gated_type": "ELIGIBLE",
        "categories": [
          "UNKNOWN"
        ],
        "is_aaa_eligible": false,
        "contains_digital_created_media": false,
        "reach_estimate": null,
        "currency": "",
        "spend": null,
        "end_date": 1788850800,
        "publisher_platform": [
          "FACEBOOK",
          "INSTAGRAM"
        ],
        "start_date": 1744009200,
        "contains_sensitive_content": false,
        "total_active_time": null,
        "regional_regulation_data": {
          "finserv": {
            "is_deemed_finserv": false,
            "is_limited_delivery": false
          },
          "tw_anti_scam": {
            "is_limited_delivery": false
          }
        },
        "hide_data_status": "NONE",
        "fev_info": null,
        "ad_id": null,
        "targeted_or_reached_countries": [],
        "url": "https://www.facebook.com/ads/library?id=1702938977100376",
        "start_date_string": "2025-04-07T07:00:00.000Z",
        "end_date_string": "2026-09-08T07:00:00.000Z"
      },
      {
        "ad_archive_id": "1559738104701476",
        "collation_count": null,
        "collation_id": null,
        "is_active": true,
        "page_id": "15087023444",
        "page_is_deleted": false,
        "snapshot": {
          "branded_content": null,
          "page_id": "15087023444",
          "page_is_deleted": false,
          "page_profile_uri": "https://www.facebook.com/nike/",
          "root_reshared_post": null,
          "byline": null,
          "disclaimer_label": null,
          "page_name": "Nike",
          "page_profile_picture_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/400027547_358739853502630_8144226094621458298_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Qd5wHjFG2_UQ7kNvwG5X4vd&_nc_oc=Adqb9WNq0Ou_p789CE-dOJzb5BX7oH8VcIUegiS9xvlGc5aoTese6PJ-2OrsPaXyXYc&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQKuEQO08jjTN5eRtD6BHcAbvB01IBM6DUCv2EjsGIAvGg…",
          "event": null,
          "caption": "play.google.com",
          "cta_text": "Install now",
          "cards": [
            {
              "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
              "cta_type": "INSTALL_MOBILE_APP",
              "caption": "play.google.com",
              "link_description": "$2,294",
              "link_url": "https://www.nike.com/mx/t/calzado-air-force-1-07-WGq1wQ?cp=54413048966_soc_",
              "title": "Calzado para mujer Nike Air Force 1 '07 - Blanco",
              "cta_text": "Install Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": [],
              "original_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/400057885_876651337399777_1711677532442992421_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BAlR-9NyaAkQ7kNvwGoS-Ci&_nc_oc=AdqlPo60bKPAtixP-nBxRyRJkWITMXlasLYpFzRNui2iKtG3vERIudftGPJdZUIsA8g&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQIpgjRKu4xDm9t_C9nTsucwbWEyizM_ozXjaLDZkjNRVQ&oe=6AA643AA",
              "resized_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/400057885_876651337399777_1711677532442992421_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BAlR-9NyaAkQ7kNvwGoS-Ci&_nc_oc=AdqlPo60bKPAtixP-nBxRyRJkWITMXlasLYpFzRNui2iKtG3vERIudftGPJdZUIsA8g&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQJqOLXii1UMvAperL5zsbpTwO-AVWCH-viKKNig4nd6…",
              "watermarked_resized_image_url": ""
            },
            {
              "body": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!",
              "cta_type": "INSTALL_MOBILE_APP",
              "caption": "play.google.com",
              "link_description": "$2,699",
              "link_url": "https://www.nike.com/mx/t/calzado-blazer-mid-77-se-j99WT3?cp=54413048966_soc_",
              "title": "Calzado para hombre Nike Blazer Mid '77 SE - Blanco",
              "cta_text": "Install Now",
              "video_hd_url": null,
              "video_preview_image_url": null,
              "video_sd_url": null,
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null,
              "image_crops": [],
              "original_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/400107091_3246840442276703_8782322399633680368_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=tclviVOvbioQ7kNvwEZp0cV&_nc_oc=AdqewoHY3YpxYaK1ptWo63fiHwC6jsZz_JJDbS4Lp1oJ5N7kggmjsMCVhETMiDo48IU&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQK5jMtlGex9KNxiZDW4L5h5l04x-RLwoGxt2HUg-x8N6g&oe=6AA63169",
              "resized_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/400107091_3246840442276703_8782322399633680368_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=tclviVOvbioQ7kNvwEZp0cV&_nc_oc=AdqewoHY3YpxYaK1ptWo63fiHwC6jsZz_JJDbS4Lp1oJ5N7kggmjsMCVhETMiDo48IU&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=TTQuL_Z0X2Q8-nDxyJGG1A&_nc_ss=7f289&oh=00_AQKcJX6Fb6nfqEvdkexHRw4OEE-foXnQWzMqbL4egaT…",
              "watermarked_resized_image_url": ""
            }
          ],
          "body": {
            "text": "Encuentra tu mejor estilo.\nLlegó el momento de que disfrutes los beneficios que la Nike App tiene para ti 😎. ¡Descárgala ahora!"
          },
          "cta_type": "INSTALL_MOBILE_APP",
          "display_format": "DPA",
          "link_description": "$2,294",
          "link_url": "http://play.google.com/store/apps/details?id=com.nike.omega",
          "images": [],
          "page_categories": [
            "Sportswear",
            "Product/service"
          ],
          "page_like_count": 39546884,
          "title": "Calzado para mujer Nike Air Force 1 '07 - Blanco",
          "videos": [],
          "is_reshared": false,
          "extra_links": [],
          "extra_texts": [],
          "extra_images": [],
          "extra_videos": [],
          "country_iso_code": null,
          "brazil_tax_id": null,
          "additional_info": null,
          "ec_certificates": []
        },
        "has_user_reported": false,
        "report_count": null,
        "menu_items": [],
        "state_media_run_label": null,
        "page_name": "Nike",
        "impressions_with_index": {
          "impressions_text": null,
          "impressions_index": -1
        },
        "gated_type": "ELIGIBLE",
        "categories": [
          "UNKNOWN"
        ],
        "is_aaa_eligible": false,
        "contains_digital_created_media": false,
        "reach_estimate": null,
        "currency": "",
        "spend": null,
        "end_date": 1788850800,
        "publisher_platform": [
          "FACEBOOK",
          "INSTAGRAM"
        ],
        "start_date": 1745564400,
        "contains_sensitive_content": false,
        "total_active_time": null,
        "regional_regulation_data": {
          "finserv": {
            "is_deemed_finserv": false,
            "is_limited_delivery": false
          },
          "tw_anti_scam": {
            "is_limited_delivery": false
          }
        },
        "hide_data_status": "NONE",
        "fev_info": null,
        "ad_id": null,
        "targeted_or_reached_countries": [],
        "url": "https://www.facebook.com/ads/library?id=1559738104701476",
        "start_date_string": "2025-04-25T07:00:00.000Z",
        "end_date_string": "2026-09-08T07:00:00.000Z"
      }
    ],
    "searchResultsCount": 3426,
    "cursor": "AQHTptg6j0gjEn5YGDki-qBTR1kmrdyml5kFhBCRfplUbXGaLXasRlYI4ZTdPJAT-QR5"
  }
}

Getting more results

Each response includes a cursor. Pass it back as cursor to fetch the next 30 ads. Repeat until no cursor is returned.

two calls

# Call 1 — first 30 ads
curl "https://fastfetchz.com/v1/facebook-ad-library/company-ads?target=Nike" \
  -H "X-API-Key: $FASTFETCHZ_KEY"
# -> { "data": { ... }, "cursor": "eyJwYWdlIjoyfQ" }

# Call 2 — next 30 ads
curl "https://fastfetchz.com/v1/facebook-ad-library/company-ads?target=Nike&cursor=eyJwYWdlIjoyfQ" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Limits

Maximum per call: 30 ads.
Minimum per call: 1 ad — a target with less data returns fewer ads, and an empty result is still a successful call.
Each call fetches a full page of up to 30 and costs the same either way. Pass limit to receive fewer than that in the response.
Larger jobs are paginated with a cursor; there is no cap on how many pages you fetch.

What this costs in practice

300,000 ads = 10,000 calls × 1 credits per call = 10,000 credits = $0.00

Priced at the Custom pack rate: 1,000,000 credits for $0.00.

Open in the pricing calculator

Guides using this endpoint

Competitive intelligence

How to pull every ad a competitor is running on Facebook

Read an advertiser's live and past creatives straight from the public Ad Library, 30 ads per call.

Error codes

StatusCodeMeaning

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.

402insufficient_creditsYour balance is below the cost of the call. Top up to continue.

403account_suspended / key_revokedThe account is suspended or the key was revoked.

429rate_limitedOver your account's requests-per-second limit. Retrying helps: the body carries retry_after_seconds and the response carries a Retry-After header. Not charged.

429monthly_cap_reachedThis key used the monthly call cap you set for it. Retrying will not help — raise the cap, use another key, or wait for the next calendar month. No Retry-After header is sent. Not charged.

500upstream_errorUnexpected failure while fulfilling the request. Not charged.