Brand Studio docs
Engineering manualAcquisition and cost

Meta company ad page

scrapecreators · runnable · billing sc_credits

FactValue
Providerscrapecreators
Modulebase
Runnable todayYes — a quantity-bound adapter exists
API path/v1/facebook/adLibrary/company/ads
Billing kindsc_credits
Price statusKnown — a published or measured rate is recorded
AvailabilityExecutable in selected plans; target and quantity bounds required
Query contractEnforced — the collector reads these parameters from the contract
Catalogue research date2026-09-07

Billing formula

What the provider charges for one request of this item. Provider cost is not the customer price and is not an account balance movement; the three are different numbers and this is the first of them.

credits=sum(endpoint_credits_per_billable_request); USD=credits*selected_acquisition_basis

Rates

ComponentValue
credits_per_request1

Minimum charge: {"uncached_billable_request_credits":1}

Provider limits: {}

Rate verification: verified_published.

Caveat: Not dollars per post. Endpoint docs override generic rate; only supported confirmed cache hits cost zero.

Runtime limits

LimitValue
quantity1
groups1

Frozen acquisition parameters

Creative inventory read. Frozen.

ParameterValue
Fixed parameters{"country":"US","status":"ACTIVE","sort_by":"total_impressions","media_type":"ALL"}
Server-side filtersNone
Order byNone
Page window1
Varies by targetcompany_id

Open audit flags: ACQ-6: every ad observed so far returned empty creative text. Empty copy must be disclosed as absent, never implied as captured messaging. · ACQ-6 cause found 2026-09-25 against the OpenAPI example: copy lives in snapshot.body.text, and for carousel and dynamic ads in snapshot.cards[].body. snapshot.caption is the display-link domain (for example fb.com), not copy, and the collector was falling back to it. Fixed in the collector, not by a parameter. · worker_b: confirm whether META_ADLIB_TOKEN's official lane returns creative text for free

Dated sources

  • https://docs.scrapecreators.com/v1/facebook/adlibrary/company/ads/ (read 2026-09-07)
  • https://docs.scrapecreators.com/caching/ (read 2026-09-07)

Notes from the catalogue

  • Not dollars per post. Endpoint docs override generic rate; only supported confirmed cache hits cost zero.
  • Pagination: cursor. Each page is another billable request; returned item yield is not guaranteed.

On this page