---
title: "Facebook Marketplace Item API"
method: GET
path: "/v1/facebook/marketplace-item"
tags: ["Facebook Marketplace"]
---

# Facebook Marketplace Item API

`GET /v1/facebook/marketplace-item`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/facebook/marketplace-item`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Marketplace listing — title, priceAmount, status, seller{}, condition, coords (2 credits).

Paste a Facebook Marketplace item URL and get the listing as clean JSON aligned with search rows: title, price + priceAmount (minor units), currency, categoryId, location{name,city,state,countryCode,latitude,longitude} (same object shape as Event endpoints — no flat city/state twins), cityPageId, status (available|pending|sold) with isSold/isPending/isHidden, deliveryTypes, image + photos[], createdAt, mediaUrlsExpireAt from Meta CDN oe=, plus detail-only description, condition, and seller{id,name,url,joinedAt,rating} when Facebook's public page exposes marketplace_listing_seller. Fetches are hedged: a page render that hasn't answered in ~30s gets a second render on a fresh session in parallel and the first full page wins, so one hung render no longer burns the whole call — 504 UPSTREAM_TIMEOUT (with timings) now means both attempts failed, not that one connection stalled. Flat 2 credits. Session-only isViewerSeller is never returned.

Docs: https://captapi.com/apis/facebook-marketplace-item

## Query parameters

- `url` string, required
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Platform identifier for this response (matches the endpoint's platform).
    - `id` string: Stable platform ID for the item.
    - `url` string: Canonical URL of the item.
    - `title` string: Title of the item.
    - `description` string: Description text.
    - `price` integer: Price of the item.
    - `priceFormatted` string: Formatted price string.
    - `priceAmount` integer: Price in minor units (cents) for exact arithmetic.
    - `currency` string: Currency code.
    - `categoryId` string: Category id when the platform exposes one.
    - `condition` string: Condition. Example: "Used - like new".
    - `status` string: Listing availability: "available" | "pending" | "sold". Sold listings can still be published.
    - `isSold` boolean: Convenience bool for status === sold.
    - `isPending` boolean: Convenience bool for status === pending.
    - `isHidden` boolean: Is hidden. Example: false.
    - `seller` object
      - `id` string: Id of this seller item.
      - `name` string: Name of this seller item.
      - `url` string: Canonical URL of the item.
      - `joinedAt` string: Joined at. Example: "2008-07-02T13:01:08+00:00".
    - `deliveryTypes` string[]: Delivery types (array).
    - `image` string: Cover photo URL. Signed Meta CDN — check mediaUrlsExpireAt.
    - `photos` string[]: Full photo gallery when the item page exposes it.
    - `createdAt` string: Creation date (ISO 8601).
    - `location` object
      - `name` string: Name of this location item.
      - `city` string: City. Example: "Arlington".
      - `state` string: State. Example: "VA".
      - `countryCode` string: ISO-3166 alpha-2 country code (e.g. US, MX).
      - `latitude` number: Latitude. Example: 38.888854980469.
      - `longitude` number: Longitude. Example: -77.085571289062.
    - `mediaUrlsExpireAt` string: Earliest Meta CDN oe= expiry across image + photos. Null when unparseable.

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

## Changes

- **2026-10-19** `c9b9ac5ff1bd`: 1 breaking, 4 warning, 11 info
  - the `data/location` response's property type changed from `string` to `object` for status `200`
  - removed the optional property `data/city` from the response with the `200` status
  - removed the optional property `data/latitude` from the response with the `200` status
  - removed the optional property `data/longitude` from the response with the `200` status
  - …12 more

[Operation history](https://skmtc.dev/captapi/apis/captapi-api/changes/v1/facebook/marketplace-item/get.md)

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)