Facebook Company Ads

From AnyAPI, through Joshu Data Bodega.

Part of Meta Ads (Facebook & Instagram) library advertiser.

Price: $0.00132 per call$1.32 per 1,000 calls

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

jqstring, optional
jq expression over the result envelope; its output replaces `output`. A failed expression returns the full result with `jqError`.
cursorstring, optional
Opaque pagination cursor from a previous response's nextCursor.
fieldsstring, optional
Comma-separated keys (dotted paths descend) to keep on each result item. Trims the response, not the charge.
pageIdstring, optional
Company's Ad Library page ID. Provide either pageId or companyName.
sortBystring: impressions, recent, optional
Sort order: impressions (highest first, the default) or recent (most recent).
statusstring: ALL, ACTIVE, INACTIVE, optional
Ad status filter. Defaults to ACTIVE.
countrystring, optional
Two-letter country code to scope results. Defaults to all countries.
endDatestring, optional
Filter to ads with impressions on or before this date, in YYYY-MM-DD format.
summaryboolean, optional
`true` returns only an outline: keys, item counts, per-field sizes.
languagestring, optional
Two-letter language code to filter ads (e.g. "EN", "ES", "FR").
max_itemsinteger, optional
Caps the result rows returned; `_truncated` says how many were withheld. Not the charge.
mediaTypestring: ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE, optional
Creative media type filter.
startDatestring, optional
Filter to ads with impressions on or after this date, in YYYY-MM-DD format.
companyNamestring, optional
Company name to search (e.g. "nike"). Exact-match and case-sensitive against the Meta Ad Library index; an advertiser with no indexed page returns found:false.

Call it

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "anyapi.facebook.company_ads",
    "params": {
      "sortBy": "recent",
      "companyName": "nike"
    }
  }'