Search Marketplace listings

Try in Playground

Search public Marketplace listings at explicit coordinates, with price, condition, delivery, date, availability and sorting filters.

GET/v1/facebook/marketplace/searchx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

querystringrequiredquery

Public keyword/location query, 1–512 characters.

min 1 chars · max 512 chars

Examplebicycle

latstringrequiredquery

Search latitude, -90 to 90.

max 32 chars

Example51.5072

lngstringrequiredquery

Search longitude, -180 to 180.

max 32 chars

Example-0.1276

category_idstringquery

Numeric Marketplace category ID.

radius_kmstringquery

Search radius, 0–500 kilometers; default 50.

max 32 chars

min_pricestringquery

Minimum price in major currency units, at most max_price.

max 32 chars

max_pricestringquery

Maximum price in major currency units.

max 32 chars

countstringquery

Marketplace result count, 1–100. If limit is also sent, the values must agree.

limitstringquery

Maximum result count: 1–100 for Marketplace or 1–50 for full reels. Full reels walk at most five pages within the same request budget.

sort_byenumquery

Native group or Marketplace ordering. See the enumerated request schema.

one of: suggested, distance_ascend, creation_time_descend, price_ascend, price_descend

delivery_methodenumquery

all, local_pickup or shipping.

one of: all, local_pickup, shipping

conditionenumquery

new, used_like_new/usedLikeNew, used_good/usedGood or used_fair/usedFair.

one of: new, used_like_new, used_good, used_fair, usedLikeNew, usedGood, usedFair

date_listedenumquery

all, 1, 7, 30, last_24_hours, last_7_days or last_30_days.

one of: all, 1, 7, 30, last_24_hours, last_7_days, last_30_days

availabilityenumquery

available, sold or all.

one of: available, sold, all

cursorstringquery

Opaque continuation from this service. Preserve it exactly; cursors are source- and route-specific.

min 1 chars · max 16000 chars

radiusKmstringquery

Camel-case alias for radius_km. Do not send both.

max 32 chars

minPricestringquery

Camel-case alias for min_price. Do not send both.

max 32 chars

maxPricestringquery

Camel-case alias for max_price. Do not send both.

max 32 chars

sortByenumquery

Ordering names, normalized to the native Facebook sort.

one of: suggested, distanceAscend, creationTimeDescend, priceAscend, priceDescend

deliveryMethodenumquery

all, localPickup or shipping; do not combine with delivery_method.

one of: all, localPickup, shipping

dateListedenumquery

Camel-case date windows: all, 1, 7, 30, last24Hours, last7Days or last30Days.

one of: all, 1, 7, 30, last24Hours, last7Days, last30Days

Response fields

dataobjectoptional

Normalized result with author, post, event or listing data and per-item coverage where applicable.

When include is requested: total rows, successfully enriched rows and failed rows.

hydration.totalinteger

Always included.

hydration.enrichedinteger

Always included.

hydration.failedinteger

Always included.

successboolean

True when usable public data is returned.

statusenum

success or partial on HTTP 200; failed or challenged on failure.

one of: success, partial

requestIdstring

Request correlation UUID.

sourceUrlstring

Canonical public Facebook page used for retrieval.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Completeness of this bounded response. Warnings name restricted, missing, interrupted or unavailable optional data.

coverage.sourcestring

Always included.

coverage.completeboolean

Always included.

coverage.warningsstring[]

Always included.

Counted upstream requests, decoded response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsinteger

Always included.

≥ 0

listingsobject[]

Public listings with id, url, title, price, location, primary photo, category, creation_time, listing_date_text, delivery types and availability flags.

up to 100 items

cursorstringnullable

Opaque continuation from this service. Preserve it exactly; cursors are source- and route-specific.

has_next_pageboolean

Public source has_next_page; null or empty when no value is exposed.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with explicit missing/failed auxiliary coverage.
400	`invalid_request`	Malformed, duplicate, conflicting or unsupported parameters.
401	`unauthorized`	Missing or invalid service API key.
403	`restricted_page`	The resource is private or restricted.
404	`not_found`	Unknown route or missing resource.
429	`upstream_rate_limited`	Facebook throttled retrieval.
502	`upstream_challenged` `upstream_error` `unsupported_page`	Source challenge, failure or unsupported/mismatched structure.
502	`response_too_large` `payload_too_complex` `request_limit` `unsafe_redirect`	Bounded retrieval or fixed-origin policy failed.
503	`busy`	All Facebook worker slots are occupied.
504	`timeout`	Request deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/facebook/marketplace/search?query=bicycle&lat=51.5072&lng=-0.1276" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/marketplace/search?query=bicycle&lat=51.5072&lng=-0.1276",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/marketplace/search?query=bicycle&lat=51.5072&lng=-0.1276",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Facebook Marketplace request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/facebook/marketplace/search",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "query": "bicycle",
        "lat": "51.5072",
        "lng": "-0.1276"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/facebook/marketplace/search?query=bicycle&lat=51.5072&lng=-0.1276", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/facebook/marketplace/search?query=bicycle&lat=51.5072&lng=-0.1276"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "partial",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.facebook.com/synthetic.page/",
  "fetchedAt": "2026-09-12T00:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "complete": false,
    "warnings": [
      "synthetic_example"
    ]
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1200,
    "durationMs": 500
  },
  "listings": [],
  "cursor": null,
  "has_next_page": false
}

Malformed, duplicate, conflicting or unsupported parameters.

{
  "success": false,
  "status": "failed",
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  },
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  }
}