Skip to main content
POST
Submit Facebook Ad Library Ad task

Ad Details

Collect creative, page, media, delivery status, and timing data for one public ad URL.

Request Example

One task accepts one ad URL and produces at most one normalized ad record.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string<uri>
required

Public Facebook Ad Library ad URL. One task accepts one URL.

Pattern: ^https?://(?:(?:www|m|web)\.)?facebook\.com/ads/library/?\?.*id=[0-9]+
callback_url
string<uri>

Optional URL that receives the task completion callback.

Response

Task submitted

code
integer
Example:

200

data
object