Marketplace Search

GET/v1/facebook/marketplace/search1 credit

Searches Facebook Marketplace listings around a location and returns the title, price, location, photo and status of each listing.

01Query parameters

Name	Type	Description
queryrequired	string	The search keyword.
latrequired	number	Latitude of the search center, -90 to 90.
lngrequired	number	Longitude of the search center, -180 to 180.
category_idoptional	string	A numeric Marketplace category id (listings carry it as `category_id`).
radius_kmoptional	number	Search radius in kilometres, at most 500.
min_priceoptional	number	Minimum price.
max_priceoptional	number	Maximum price.
sort_byoptional	string	Result order.Accepted values:`suggesteddistance_ascendcreation_time_descendprice_ascendprice_descend`
delivery_methodoptional	string	Delivery filter.Accepted values:`alllocal_pickupshipping`
conditionoptional	string	Item condition filter.Accepted values:`newused_like_newused_goodused_fair`
date_listedoptional	string	Listed within the last 1, 7 or 30 days (`1` and `last_24_hours` mean the same, and so on).Accepted values:`all1730last_24_hourslast_7_dayslast_30_days`
availabilityoptional	string	Availability filter.Accepted values:`availablesoldall`
cursoroptional	string	The `cursor` from the previous page.

02Request

curl "https://api.scrapesocial.ai/v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "listings": [
    {
      "id": "4498962133715634",
      "url": "https://www.facebook.com/marketplace/item/4498962133715634/",
      "title": "Roadmaster Bike",
      "creation_time": "2026-10-16T12:52:50.000Z",
      "listing_date_text": "Listed 1 week ago",
      "mileage": null,
      "custom_subtitles": [],
      "price": {
        "formatted_amount": "$60",
        "amount_with_offset_in_currency": 6000,
        "amount": 60
      },
      "strikethrough_price": null,
      "location": {
        "city": "Austin",
        "state": "TX",
        "display_name": "Austin, Texas",
        "city_page_id": "106224666074625"
      },
      "primary_photo": {
        "id": "1420646603548194",
        "url": "https://scontent.fedo1-1.fna.fbcdn.net/v/t39.84726-6/853884342_1420646606881527_2693364933188619938_n.jpg?stp=c89.0.540.540a_dst-jpg_p180x540_tt6&_nc_cat=100&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=92e707&_nc_ohc=cOXWeGUYhlQQ7kNvwEMJn9f&_nc_oc=AdqKATVw73erooguKDKHrjw8vnOMMZA3uUwRjCnT4Y23Vhy7RDjQG10t6t0mC7Nn_U8&_nc_zt=14&_nc_ht=scontent.fedo1-1.fna&_nc_gid=iUcqSLdtqJmFlP-2QVZ5FA&_nc_ss=7b289&oh=0…"
      },
      "category_id": "1658310421102081",
      "is_hidden": false,
      "is_live": true,
      "is_pending": false,
      "is_sold": false,
      "is_viewer_seller": false,
      "delivery_types": [
        "IN_PERSON"
      ],
      "story_type": "POST",
      "story_key": "28118784927798629"
    },
    {
      "id": "28921894767476661",
      "url": "https://www.facebook.com/marketplace/item/28921894767476661/",
      "title": "Kids bike",
      "creation_time": "2026-10-22T13:04:59.000Z",
      "listing_date_text": "Listed 3 days ago",
      "mileage": null,
      "custom_subtitles": [],
      "price": {
        "formatted_amount": "$50",
        "amount_with_offset_in_currency": 5000,
        "amount": 50
      },
      "strikethrough_price": null,
      "location": {
        "city": "Austin",
        "state": "TX",
        "display_name": "Dessau, Texas",
        "city_page_id": "106600749373884"
      },
      "primary_photo": {
        "id": "1900393394653895",
        "url": "https://scontent.fedo1-1.fna.fbcdn.net/v/t39.84726-6/857233002_1900393407987227_4917888034339255672_n.jpg?stp=c316.0.540.540a_dst-jpg_p180x540_tt6&_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=92e707&_nc_ohc=pQ8SQv6XoxEQ7kNvwFgMrhb&_nc_oc=AdqXuFkkUCczEr7wSeZRi8XMBKs6NsZmuWL3NlsmKovqGPeCVszQZ-hAG_ikoAbiNS0&_nc_zt=14&_nc_ht=scontent.fedo1-1.fna&_nc_gid=iUcqSLdtqJmFlP-2QVZ5FA&_nc_ss=7b289&oh=…"
      },
      "category_id": "1658310421102081",
      "is_hidden": false,
      "is_live": true,
      "is_pending": false,
      "is_sold": false,
      "is_viewer_seller": false,
      "delivery_types": [
        "IN_PERSON"
      ],
      "story_type": "POST",
      "story_key": "39386688810975374"
    }
  ],
  "cursor": "eyJwZyI6MCwiYjJjIjp7ImJyIjoiIiwiaXQiOjAsImhtc3IiOmZhbHNlLCJ0YmkiOjB9LCJjMmMiOnsiYnIiOiJBYnB0M0RyYVAta1Z4RDJJbDZ2RHFqSzl0ak9rWmhZcmhMZWtQaFZlUmk2dmtmLW56OWFxVXdranhmSXg3ZEZJU3JaS3E3UzlrMzJiNTVtVllIdndEQTVPM1BwWFpSVnZ6aGg2d1Z2YjZmRkstRkstOXRiT3U2bl9JYS1aZFU5Z0FQbF9mTHlXOXZtVjFUNG9VXzV5ZzFXcHBRd2h5RG5nSnlFb1FWUExTX3QwbEFmZ0tPSWVGUHNlM0JsVy1nVmczOGxxSTVEaDJxc2VHX3U3cmlab1JUMDd6RUxrNmx0ZUpBOXJfZ05Fd3lr…",
  "has_next_page": true
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Up to 24 listings per page; pass the response's `cursor` back while `has_next_page` is true. A search with no listings returns an empty list for 0 credits. Invalid filter values are rejected with a free 400. A page without listings ends the search: `has_next_page` is false and `cursor` null.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.