Facebook Ad Search

Inputs

• jqstring, optional

  jq expression over the result envelope; its output replaces `output`. A failed expression returns the full result with `jqError`.

• querystring, required

  Keyword to search the Meta Ad Library for (e.g. "protein powder").

• adTypestring: all, political_and_issue_ads, optional

  Restrict to all ads (default) or only political and issue ads.

• 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.

• sortBystring: impressions, recent, optional

  Sort order: impressions (highest first, the default) or recent (most recent).

• statusstring: ALL, ACTIVE, INACTIVE, optional

  Ad status filter.

• countrystring, optional

  Two-letter country code to scope results. Omit for 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.

• 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.

• searchTypestring: keyword_unordered, keyword_exact_phrase, optional

  Match mode for the query: loose keyword match (keyword_unordered, the default) or exact phrase (keyword_exact_phrase).