Facebook

Marketplace item

A Marketplace listing: its title, price, description, condition, place, photos and seller.

GET/v1/facebook/marketplace/items1 credit
x-api-key*stringrequiredheader

Your API key, made in the dashboard.

Parameters

2
item_idstringoptionalquery

A Marketplace listing's id: the digits in its link (facebook.com/marketplace/item/<id>). Give item_id or url.

example: 1656586118821988

urlstringoptionalquery

A Marketplace listing's link: facebook.com/marketplace/item/<id>. Give item_id or url.

max 300 chars

Response fields

31
dataobject

The result: one object, or a list for the endpoints that return several.

data.idstring

Facebook's id for the Marketplace listing: digits, written as text. The items endpoint takes it.

data.urlstring

The listing's page.

data.titlestringnullable

Its title.

data.pricestringnullable

Its price as Facebook writes it ($220).

data.amountnumbernullable

Its price as a number.

data.currencystringnullable

The price's currency (USD). Only the items endpoint gives it.

data.descriptionstringnullable

What the seller wrote. Only the items endpoint gives it.

data.conditionstringnullable

Its condition (Used – good). Only the items endpoint gives it.

data.locationstringnullable

Where it is (Austin, TX).

data.latitudenumbernullable

Where it is: latitude. Only the items endpoint gives it.

data.longitudenumbernullable

Where it is: longitude. Only the items endpoint gives it.

data.created_atstringnullable

When it was listed.

format: date-time

data.soldbooleannullable

Whether it's sold.

data.pendingbooleannullable

Whether a sale is pending. Only the items endpoint gives it.

data.sellerstringnullable

The seller's name.

data.seller_idstringnullable

The seller's id.

data.category_idstringnullable

Its Marketplace category's id.

data.imagestringnullable

Its first photo's link.

data.imagesstring[]nullable

Its photos' links. Only the items endpoint gives them.

pageobjectnullable

Paging, for the endpoints that page; null for the others.

page.next_cursorstringnullable

Send it as the cursor parameter, with the same other parameters, for the next page. Null on the last page.

page.has_morebooleanoptional

Whether another page follows.

default: false

metaobject

About this call.

meta.platformstring

The platform: reddit, threads, tiktok or youtube.

meta.endpointstring

The endpoint's name, such as channel_videos.

meta.paramsobject

The call's parameters, defaults included. Parameters without a value, and the cursor, are left out.

meta.request_idstring

This call's id. Quote it when you report a problem.

meta.api_versionstring

The API version that answered.

meta.fetched_atstring

When the data was fetched from the platform (UTC).

format: date-time

meta.cachedbooleanoptional

Whether it came from our cache; fetched_at says how old it is.

default: false

Code example

curl -X GET 'https://api.socialparse.dev/v1/facebook/marketplace/items?item_id=1656586118821988' \  -H 'x-api-key: YOUR_API_KEY'

Responses

Successful Response

{  "data": {    "id": "string",    "url": "string",    "title": "string",    "price": "string",    "amount": 0,    "currency": "string",    "description": "string",    "condition": "string",    "location": "string",    "latitude": 0,    "longitude": 0,    "created_at": "2019-08-24T14:15:22Z",    "sold": true,    "pending": true,    "seller": "string",    "seller_id": "string",    "category_id": "string",    "image": "string",    "images": [      "string"    ]  },  "page": {    "next_cursor": "string",    "has_more": false  },  "meta": {    "platform": "string",    "endpoint": "string",    "params": {      "property1": "string",      "property2": "string"    },    "request_id": "string",    "api_version": "string",    "fetched_at": "2019-08-24T14:15:22Z",    "cached": false  }}