Facebook Marketplace Item API

Facebook Marketplace Item

Features

• Known item URL inputProcess public facebook.com, www.facebook.com, m.facebook.com, or web.facebook.com paths beginning with /marketplace/item/{numeric_id}, keeping collection scoped to the submitted listings.
• Normalized listing detailsReturn listing identity, title, description, seller context, price, location, images, attributes, delivery values, timestamps, and public availability fields when exposed.
• Independent batch processingHandle each valid URL independently and return at most one listing per URL, so an unavailable item does not stop the remaining inputs from being processed.
• Explicit public-data boundaryKeep source-dependent seller, location, media, attribute, delivery, and status values nullable instead of creating placeholder details for fields the public listing does not expose.

Parameters

How to Use

Submit known public Marketplace item URLs, track the asynchronous task, and read normalized listing records with cursor pagination.

1. Prepare one or more public Facebook Marketplace URLs whose path begins with /marketplace/item/{numeric_id}.
2. Submit the links as urls to /v1/facebook-marketplace/item and capture task_id.
3. Poll /v1/tasks/{task_id} until processing succeeds or returns a failure.
4. Read data.results.items, then request the next page with next_cursor while has_more is true.

curl -X POST "https://api.socq.ai/v1/facebook-marketplace/item" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/marketplace/item/1656586118821988/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Best Use Cases

• Enrich selected search results: Use listing descriptions, seller fields, additional media, attributes, delivery values, and precise location context to expand a chosen set of Marketplace search results.
• Recheck price and availability: Compare normalized price, strikethrough price, availability text, and live, pending, sold, shipping, buy-now, or messaging flags for known listing URLs.
• Compare selected item attributes: Organize titles, categories, condition attributes, locations, delivery types, prices, and media across a defined list of public items.
• Preserve listing snapshots: Store listing identity, source URL, public content, state fields, created_at, and collected_at as a point-in-time record for later comparison.

Pro Tips

• Validate every host and /marketplace/item/{numeric_id} path and remove duplicate URL strings before submission, because one invalid URL rejects the request and exact duplicates are processed only once.
• Treat fewer returned records than submitted URLs as a valid outcome because an unavailable or not-found item is skipped instead of becoming a placeholder listing.
• Handle seller identity, coordinates, description, media, attributes, delivery values, creation time, and public state flags as optional source-dependent fields.
• Store extra.input_url with collected_at so each returned listing remains tied to its submitted URL and observation time.
• For batches whose successful results exceed the current result page, follow next_cursor while has_more is true instead of assuming the first page is complete.

Related APIs