Previous value: -"Opaque pagination cursor from a previous nextCursor."New value: +"Opaque pagination cursor from a previous nextCursor. A cursor this endpoint did not issue is 400 INVALID_CURSOR."

Previous value: -"When true, adds description/condition/coordinates/full photo gallery/seller/distanceMiles — billed as 2 + 2 credits per listing. Default false → flat 2 credits; cover photo is still in image."New value: +"When true, adds description/condition/coordinates/full photo gallery/seller/distanceMiles — billed as 2 + 2 credits per enriched listing (listings the 90s deadline did not reach ship as search cards with truncatedReason=enrich_deadline and are not billed the extra 2). Default false → flat 2 credits; cover photo is still in image."

Previous value: -"Search-origin city or place name, e.g. 'Austin, TX'. Required — there is no default city. Echoed on the envelope and inside filters. Not listings[].location."New value: +"Search-origin city or place name, e.g. 'Austin, TX'. Required — there is no default city. Echoed on the envelope and inside filters. Not listings[].location. Names that don't resolve to a real place are a definitive 400 UNKNOWN_LOCATION (Facebook would otherwise silently search an unrelated metro) — /v1/facebook/marketplace-location-search finds valid ones."

Previous value: -"1 (24h), 7, or 30."New value: +"Facebook calendar-day recency: 1 = since the start of yesterday (not a rolling 24 hours), 7, or 30."

Previous value: -"Search-origin city or place name, e.g. 'Austin, TX' (query echo — not each listing's city)."New value: +"Alias of searchLocation. Prefer searchLocation. Either one is required."

Added value: +{
+  "description": "Search-origin city or place name, e.g. 'Austin, TX'. Required — there is no default city. Echoed on the envelope and inside filters. Not listings[].location.",
+  "type": "string"
+}

Previous value: -[
-  "q",
-  "location"
-]New value: +[
+  "q",
+  "searchLocation"
+]

Previous value: -"Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits."New value: +"Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."

Previous value: -"Set true to serve from the 24h response cache. Default false — always fetch fresh data."New value: +"Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh. Envelope includes cached + cachedAt on hits."

Previous value: -"new, like_new, good, fair."New value: +"new, like_new, good, fair (comma-separated ok)."

Previous value: -"Pagination cursor from a previous nextCursor."New value: +"Opaque pagination cursor from a previous nextCursor."

Previous value: -"local_pickup | shipping | all."New value: +"local_pickup | shipping | all. Shipped listings can appear nationwide outside radiusMiles — use local_pickup for nearby-only; rows expose isLocal / shipsOutsideRadius."

Previous value: -"Set true for description/condition/coordinates/full gallery (2 + 2 credits per listing). Cover photo is included even when false."New value: +"When true, adds description/condition/coordinates/full photo gallery/seller/distanceMiles — billed as 2 + 2 credits per listing. Default false → flat 2 credits; cover photo is still in image."

Previous value: -"string"New value: +"boolean"

Previous value: -"Max items to return. Default 20, max 200. Flat 2 credits per call."New value: +"How many listings to return (1–200). Flat 2 credits when details=false; details=true billed as 2 + 2 per listing."

Previous value: -"City or place name, e.g. 'Austin, TX'."New value: +"Search-origin city or place name, e.g. 'Austin, TX' (query echo — not each listing's city)."

Previous value: -"Product or keyword to search for (min 2 chars)."New value: +"Product or keyword to search Facebook Marketplace for."

Previous value: -"Radius in miles (1–500 discrete values)."New value: +"Radius in miles: 1,2,5,10,20,40,60,80,100,250,500. Does not exclude nationwide shipped inventory."

Added value: +{
+  "description": "available | sold | all.",
+  "type": "string"
+}

Added value: +{
+  "description": "Top-level category slug, e.g. electronics.",
+  "type": "string"
+}

Added value: +{
+  "description": "new, like_new, good, fair.",
+  "type": "string"
+}

Added value: +{
+  "description": "Pagination cursor from a previous nextCursor.",
+  "type": "string"
+}

Added value: +{
+  "description": "1 (24h), 7, or 30.",
+  "type": "string"
+}

Added value: +{
+  "description": "local_pickup | shipping | all.",
+  "type": "string"
+}

Previous value: -"Set true to fetch full description, photos and coordinates per listing (slower, costs more)."New value: +"Set true for description/condition/coordinates/full gallery (2 + 2 credits per listing). Cover photo is included even when false."

Previous value: -"Max items to return. Default 20, max 200. Billed per result."New value: +"Max items to return. Default 20, max 200. Flat 2 credits per call."

Added value: +{
+  "description": "Maximum price in local currency units.",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Minimum price in local currency units.",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Radius in miles (1–500 discrete values).",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "suggested | distance | creation_time | price_ascend | price_descend.",
+  "type": "string"
+}

Previous value: -"Set true to enrich each listing with description, photos and coordinates (2 + 2 credits per listing)."New value: +"Set true to fetch full description, photos and coordinates per listing (slower, costs more)."

Previous value: -"Max items to return. Flat 2 credits per call."New value: +"Max items to return. Default 20, max 200. Billed per result."

Previous value: -"Set true to fetch full description, photos and coordinates per listing (slower, costs more)."New value: +"Set true to enrich each listing with description, photos and coordinates (2 + 2 credits per listing)."

Previous value: -"Max items to return. Default 20, max 200. Billed per result."New value: +"Max items to return. Flat 2 credits per call."

Previous value: -"Responses are cached for 24 hours by default. Set false to bypass the cache and always fetch fresh data (default true)."New value: +"Set true to serve from the 24h response cache. Default false — always fetch fresh data."

Added value: +{
+  "description": "Responses are cached for 24 hours by default. Set false to bypass the cache and always fetch fresh data (default true).",
+  "type": "boolean"
+}