Get a Marketplace listing

Try in Playground

Retrieve one public listing with price, description, condition, category, attributes, photos, videos, hashtags and availability flags.

GET/v1/facebook/marketplace/itemx-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

urlstringquery

Public HTTPS Facebook resource URL. Common tracking parameters are stripped; credentials, ports, lookalike hosts, traversal and unsupported paths are rejected.

max 4096 chars

idstringquery

Numeric public resource identifier.

Example300000000000001

Response fields

idstring

Numeric public resource identifier.

urlstring

Public HTTPS Facebook resource URL. Common tracking parameters are stripped; credentials, ports, lookalike hosts, traversal and unsupported paths are rejected.

titlestring

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

descriptionstringnullable

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

creation_timestringnullable

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

listing_date_textstringnullable

Listing age as text, for example "Listed 4 days ago". The source text when exposed, otherwise stated from creation_time; null when neither is known.

availability_textstringnullable

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

location_textstringnullable

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

locationobjectnullable

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

priceobjectnullable

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

mileageJSONnullableoptional

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

strikethrough_priceobjectnullable

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

category_idstringnullable

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

category_namestringnullable

Public category name of the listing; null when not exposed.

Category path from the top-level category down, each with name and browsable slug.

up to 16 items

category_path.namestringnullable

Always included.

category_path.slugstringnullable

Always included.

conditionstringnullable

Item condition value (new, used_like_new, used_good, used_fair); null when the listing states none.

inventory_typestringnullable

Source inventory type, for example SINGLE; null when not exposed.

inventory_countnumbernullable

Units available when the listing states a quantity; otherwise null.

hashtagsstring[]

Hashtags attached to the listing, without the # sign.

up to 100 items

attributesobject[]

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

up to 100 items

photosobject[]

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

up to 100 items

Listing videos with id and playable url; empty when the listing has none. Media is returned as data, never downloaded.

up to 100 items

videos.idstringnullable

Always included.

videos.urlstringnullable

Always included.

is_hiddenbooleannullable

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

is_livebooleannullable

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

is_pendingbooleannullable

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

is_soldbooleannullable

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

is_viewer_sellerbooleannullable

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

is_shipping_offeredbooleannullable

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

is_buy_now_enabledbooleannullable

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

messaging_enabledbooleannullable

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

delivery_typesstring[]

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

share_uristringnullable

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

sellerobjectnullable

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

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

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/item?id=300000000000001" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/facebook/marketplace/item?id=300000000000001",
  {
    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/item?id=300000000000001",
  {
    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/item",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "id": "300000000000001"
    },
    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/item?id=300000000000001", 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/item?id=300000000000001"))
            .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.

{
  "id": "100000000000001",
  "url": "https://www.facebook.com/synthetic.page/",
  "title": "Synthetic title",
  "description": null,
  "creation_time": null,
  "listing_date_text": null,
  "availability_text": null,
  "location_text": null,
  "location": null,
  "price": null,
  "mileage": null,
  "strikethrough_price": null,
  "category_id": null,
  "category_name": null,
  "category_path": [],
  "condition": null,
  "inventory_type": null,
  "inventory_count": null,
  "hashtags": [],
  "attributes": [],
  "photos": [],
  "videos": [],
  "is_hidden": null,
  "is_live": null,
  "is_pending": null,
  "is_sold": null,
  "is_viewer_seller": null,
  "is_shipping_offered": null,
  "is_buy_now_enabled": null,
  "messaging_enabled": null,
  "delivery_types": [],
  "share_uri": null,
  "seller": null,
  "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
  }
}

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
  }
}