Catalog / Social, content & reviews
SOCIAL, CONTENT & REVIEWS
Facebook Marketplace
Search Facebook Marketplace by keyword, city, category, price, condition and date listed.
About this data
Search Facebook Marketplace by keyword, city, category, price, condition and date listed. Get title, price, currency, location, photo, seller and posting time for every listing, plus description, condition and vehicle details on request. No Facebook account needed.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/facebook/marketplace/listings
Up to three public Marketplace cards from one search page: listing ID/link, title, price/currency, city/state, image, posted time and sold/pending status where published.
Seller names, profile information and raw subtitles are removed.
No item-detail requests or scroll pages.
A complete, explicitly empty search connection returns no records.
Input
Send a JSON body to POST https://api.ssh.autos/v1/facebook/marketplace/listings.
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | required | 1–150 characters |
location | string | optional | pattern ^[a-z0-9][a-z0-9-]{0,59}$; default "nyc" |
maxResults | integer | optional | 1–3; default 3 |
Returned fields
The answer is JSON: records, a list of up to 3, and summary, the run status and counts. Each record has these 26 fields; a field the source does not publish comes back null.
26 fields per record
| Field | Type | Notes |
|---|---|---|
listingId | string | Marketplace listing id. |
url | string | Listing page. |
price | number | Asking price in the listing's currency (0 for free items). |
priceText | string | Price as shown, for example $1,200 or CA$20. |
currency | string | ISO currency code. |
originalPriceText | string | Earlier price shown struck through after a price drop. |
city | string | — |
state | string | — |
locationText | string | Place as shown on the listing. |
imageUrl | string | Main photo. |
photos | array of strings | All photos (with full details). |
postedAt | string | When the listing was posted (UTC, ISO 8601). |
isSold | boolean | — |
isPending | boolean | — |
deliveryTypes | array of strings | IN_PERSON, DOOR_PICKUP, SHIPPING_OFFSITE, ... |
shippingOffered | boolean | With full details. |
categoryId | string | — |
categoryName | string | With full details. |
condition | string | For example Used - like new (with full details). |
attributes | array of objects | Listing attributes such as condition or brand (with full details). |
vehicle | object | Vehicle listings with full details. |
detailLevel | string | one of listing, full |
searchInput | string | The search term, category or link you supplied. |
searchUrl | string | The Marketplace search the row came from. |
scrapedAt | string | — |
error | null | Always null in the dataset. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/facebook/marketplace/listings -m POST -b '{"query": "bicycle", "location": "nyc", "maxResults": 2}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Facebook Marketplace Scraper. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt