Facebook Marketplace Read API
Anonymous, read-only access to public Facebook Marketplace category links, contextual search results, observed filter controls, and listing details. Results are retrieved live through Facebook's public pages; listing identity is scoped to the returned Facebook listing ID and canonical URL.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.
Then ask your agent to use the Facebook Marketplace Read API for your task.
Call it over HTTP
Get an API keySign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/c93db173-463b-4abe-a4f8-2120a4a69899/v1/marketplace/categories' \
--header "Authorization: Bearer $AGENT_DATA_API_KEY"Endpoints
Inputs and response fields for every endpoint in this API.
GETMarketplace categories/v1/marketplace/categories
Fetch the categories currently linked by the public Marketplace home page. Use a returned category_id or pass the unchanged returned url as category_url to listings; numeric search links are directly supported, while no-ID URLs are truthfully marked category-specific/unknown until their caller-invoked source response is read. The list is page-contextual, not a universal taxonomy.
Input
No input parameters.
Response
itemsobject[]items[].urlstringitems[].slug?string | nullitems[].labelstringitems[].category_id?string | nullitems[].source_pathstringitems[].listing_search_supportedboolean | nullitems[].listing_search_limitation?string | nullcoveragestringsource_urlstringreturned_countintegerFields marked ? are optional.
GETMarketplace filters/v1/marketplace/filters
Inspect structured filter and sort controls rendered for a location/category/query context, including exact source display names, opaque/source values, active state, range metadata, and filter type. This operation reports what Facebook rendered; it does not invent universal options or apply controls whose URL encoding was not exposed by the public page.
Input
locationOptionalQuery · string, default: 103133213059698Facebook Marketplace location token: a source-recognized location ID or slug returned/used by Marketplace URLs.
Example: 103133213059698
queryOptionalQuery · string | nullOptional Facebook Marketplace search text.
Example: Vehicles
category_idOptionalQuery · string | nullOptional Facebook category ID obtained from the categories operation.
Example: 546583916084032
category_urlOptionalQuery · string | nullComplete category URL copied unchanged from categories[].url. Query/category_id must be omitted when this is supplied; category pages without a numeric ID are retained but may not expose a public listing data surface.
Example: https://www.facebook.com/marketplace/103133213059698/search/?category_id=546583916084032&query=Vehicles
Response
groupsobject[]groups[].namestringgroups[].range?object | nullgroups[].valuesobject[]groups[].values[].value?string | nullgroups[].values[].active?boolean | nullgroups[].values[].display_namestringgroups[].values[].source_record?objectgroups[].field_key?string | nullgroups[].filter_keystringgroups[].filter_type?string | nullgroups[].source_record?objectcoveragestringsource_urlstringFields marked ? are optional.
GETMarketplace listings/v1/marketplace/listings
Retrieve the live Facebook-ranked listing collection for a source-recognized location, optional query, and optional category. Facebook's public HTML currently embeds an opaque Relay cursor but a controlled anonymous HTTP replay of it repeats the first page, so this API does not claim callable pagination. Each item is a listing summary; call the detail operation separately for description, attributes, full photos, and seller details.
Input
locationOptionalQuery · string, default: 103133213059698Facebook Marketplace location token: a source-recognized location ID or slug.
Example: 103133213059698
queryOptionalQuery · string | nullOptional free-text query passed to Facebook Marketplace.
Example: Vehicles
category_idOptionalQuery · string | nullOptional Facebook category ID returned by categories.
Example: 546583916084032
category_urlOptionalQuery · string | nullComplete category URL copied unchanged from categories[].url. Query/category_id must be omitted when this is supplied. Facebook category URLs without numeric IDs are accepted as a source reference but currently return a typed source-shape error because their anonymous HTML exposed no listing-search data.
Example: https://www.facebook.com/marketplace/103133213059698/search/?category_id=546583916084032&query=Vehicles
Response
itemsobject[]items[].idstringitems[].url?string | nullitems[].price?objectitems[].price.amountstringitems[].price.currency?string | nullitems[].price.formatted?string | nullitems[].price.amount_with_offset_in_currency?string | nullitems[].title?string | nullitems[].seller?object | nullitems[].is_live?boolean | nullitems[].is_sold?boolean | nullitems[].location?object | nullitems[].subtitle?string[]items[].category_id?string | nullitems[].primary_photo?object | nullitems[].source_record?objectitems[].delivery_types?string[]items[].created_at_unix?integer | nullitems[].source_story_type?string | nullitems[].strikethrough_price?objectitems[].strikethrough_price.amountstringitems[].strikethrough_price.currency?string | nullitems[].strikethrough_price.formatted?string | nullitems[].strikethrough_price.amount_with_offset_in_currency?string | nullorderingstringsession_id?string | nullsource_urlstringreturned_countintegercontinuation_notestringsource_next_cursorstring | nullcontinuation_supportedbooleanFields marked ? are optional.
GETMarketplace listing detail/v1/marketplace/listings/{listing_id}
Fetch one public listing by its Facebook Marketplace listing ID. Pass an id unchanged from marketplace-listings.items[].id. This caller-invoked detail read is intentionally separate from search and does not enrich every search result.
Input
listing_idRequiredPath · stringFacebook Marketplace listing ID returned by the listings operation.
Example: 1810869790221056
Response
idstringurl?string | nullprice?objectprice.amountstringprice.currency?string | nullprice.formatted?string | nullprice.amount_with_offset_in_currency?string | nulltitle?string | nullphotos?object[]seller?object | nullis_live?boolean | nullis_sold?boolean | nullcategory?string | nulllocation?object | nullsubtitle?string[]condition?string | nullattributes?object[]source_urlstringcategory_id?string | nullcoordinates?object | nulldescription?string | nullcategory_slug?string | nulllocation_text?string | nullprimary_photo?object | nullsource_record?objectdelivery_types?string[]created_at_unix?integer | nullrelated_searches?string[]renderable_status?string | nullsource_story_type?string | nullstrikethrough_price?objectstrikethrough_price.amountstringstrikethrough_price.currency?string | nullstrikethrough_price.formatted?string | nullstrikethrough_price.amount_with_offset_in_currency?string | nullFields marked ? are optional.
Don’t see the endpoint you need?
Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.
An account is required to submit an extension. Prepare your request, then sign in to build.