Facebook Marketplace Listing Data API

Find & Flip provides keyword searches for current Facebook Marketplace listings through a prepaid API. Use location and price filters, then retrieve the available listing data as JSON.

Read the public docs Create an API key

What the API does

Facebook Marketplace Listing Data API, explained

Find & Flip provides keyword searches for current Facebook Marketplace listings through a prepaid API. Use location and price filters, then retrieve the available listing data as JSON.

Pricing in USD

$1.50 / 1,000 listings

20 returned listings cost $0.03 at standard rates. Prepaid API credits start at $10. No API subscription is required; API credits are separate from sourcing plans and AI credits.

Creating a search reserves its maximum cost. Only returned listings are billed; unused reservations are released. Status checks, repeated result reads, and empty searches have no listing charge. Custom account rates are shown by GET /api/v1/balance.

Supported markets and coverage

Location-based searches accept an optional postal code and radius of 1–500 miles. Availability depends on marketplace results and worker coverage; this is not a complete national or worldwide feed. Confirm coverage for your target location before building around it.

Searches are asynchronous. Results depend on source availability and worker capacity; no fixed response time or completeness guarantee is advertised.

Request and response examples

Documentation is public. A verified account, an API key, and sufficient prepaid credits are required to run searches.

1. Submit a search

curl -X POST 'https://findandflip.io/api/v1/jobs' \
  -H 'Authorization: Bearer ffapi_YOUR_KEY' \
  -H 'Idempotency-Key: example-search-001' \
  -H 'Content-Type: application/json' \
  -d '{"marketplace": "facebook", "query": "Nintendo Switch OLED", "searchZip": "49024", "maxRadius": 25, "maxPrice": 200, "maxResults": 20, "collectAdditionalDetails": true}'

The response includes an id and job status. Save that ID.

2. Poll status, then read results

GET /api/v1/jobs/{job_id}
GET /api/v1/jobs/{job_id}/results?offset=0&limit=50

Send the same Bearer header for reads. Poll every 2–5 seconds. Read results after completed; requesting them earlier returns 409.

Illustrative results JSON

Synthetic example only. These are not live listings or verified sales. Source fields vary and can be missing or null. eBay soldPrice is numeric; other marketplaces expose price as source text.

{
  "jobId": "67b201a6-c3b5-49fc-9f82-d3e50281e761",
  "marketplace": "facebook",
  "offset": 0,
  "count": 1,
  "total": 1,
  "items": [
    {
      "marketplace": "facebook",
      "title": "Nintendo Switch OLED console",
      "price": "$160",
      "location": "Portage, MI"
    }
  ]
}

Limits and important distinctions

These are current asking prices, not verified sold prices. Listings can change or disappear. Additional details depend on what the marketplace exposes; seller, condition, and description fields may be missing. Find & Flip is independent of Meta and does not provide an official Meta data feed.

Request 1–50 results per search; fewer may be returned.
120 requests per key per minute; normally two active searches per account, subject to worker capacity.
Use the same Idempotency-Key and request body when retrying. A new key creates an independently billable search.
Respect Retry-After on 429 responses. Failed or cancelled jobs release their reservation; completed jobs retain their final charge.
Find & Flip supplies listing research. You remain responsible for checking condition, authenticity, fees, and resale assumptions.

All parameters · Errors and limits · OpenAPI schema · Ask about coverage or volume pricing

Facebook Marketplace Listing Data API