Skip to main content
Reads a Meta Ad Library search page with a q keyword, a page view with a view_all_page_id, or an ad page with an id, and returns its data as JSON.

Make a request

Send the page’s URL to scrape with a json format that names the parser. Get an API key in the Quickstart.

Read the response

The parser’s data is in data.json. Its fields include adId, adUrl, pageId, pageName, pageUrl and pageAvatarUrl. This sample is cut to the first items.

Options

Send options in the options object of the json format.

Price

$1 per 1,000 calls. See Pricing.

Limits and errors

  • The URL must be a Meta Ad Library search page with a q keyword, a page view with a view_all_page_id, or an ad page with an id. Any other URL fails with invalidRequest.
  • To read the next page, send the cursor from the response as the cursor option. Paging needs an API key.
  • The answer comes back in data.json. If the page cannot be read, the call fails with an error code from Errors.