Skip to main content
POST
Submit Facebook Marketplace Item task

Marketplace Item

Collect detailed listing information from one or more public Marketplace item URLs. Each URL is processed independently and can produce at most one listing. If an item is unavailable or not found, the remaining URLs continue processing.

Request Example

Billing is based on the number of item records successfully returned. URLs that do not produce a record are not included in the final charge.

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
urls
string<uri>[]
required

Public Facebook Marketplace item URLs. Each URL can produce at most one listing.

Minimum array length: 1
Pattern: ^https?://(?:(?:www|m|web)\.)?facebook\.com/marketplace/item/[0-9]+(?:/|$)
callback_url
string<uri>

Optional URL that receives the task completion callback.

Response

Task submitted

code
integer
Example:

200

data
object