Facebook Marketplace Marketplace Search API

Search Facebook Marketplace listings

1 creditper request
GET
/v1/facebook/marketplace/search
curl "https://api.scrapecreators.com/v1/facebook/marketplace/search" \
  -H "x-api-key: "
{
  "success": true,
  "credits_remaining": 49997831258,
  "credits_charged": 1,
  "listings": [
    {
      "id": "1880804689276480",
      "url": "https://www.facebook.com/marketplace/item/1880804689276480/",
      "title": "ANCHEER E Bike",
      "creation_time": null,
      "listing_date_text": null,
      "price": {
        "formatted_amount": "$300",
        "amount_with_offset_in_currency": 30000,
        "amount": 300
      },
      "strikethrough_price": null,
      "location": {
        "city": "Austin",
        "state": "TX",
        "display_name": "Austin, Texas",
        "city_page_id": "106224666074625"
      },
      "primary_photo": {
        "id": "742022888999863",
        "url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/696326464_742022902333195_6718077421452400338_n.jpg?stp=c43.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=106&ccb=1-7&_nc_sid=92e707&_nc_ohc=dzY2b4-6EowQ7kNvwFDgohs&_nc_oc=AdomRHPRV49gouEOWqxlFxuEeLcoc5cBjRhXhi91oslqlUNdZ9EV-te1C_pvL-eyVzs&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=GvS1066o3EBgpWuqL6BQZA&_nc_ss=7e289&oh=00_Af6M2kbWMsKLjEHmSUv6oiPJt3skIfetxG3oB2YOIiDuTg&oe=6A0D6E08"
      },
      "category_id": "1658310421102081",
      "is_hidden": false,
      "is_live": true,
      "is_pending": false,
      "is_sold": false,
      "is_viewer_seller": false,
      "delivery_types": [
        "IN_PERSON",
        "PUBLIC_MEETUP",
        "DOOR_PICKUP",
        "DOOR_DROPOFF"
      ],
      "story_type": "POST",
      "story_key": "26881002338175809"
    },
    {
      "id": "950860437561765",
      "url": "https://www.facebook.com/marketplace/item/950860437561765/",
      "title": "Mountain Bike",
      "creation_time": null,
      "listing_date_text": null,
      "price": {
        "formatted_amount": "$60",
        "amount_with_offset_in_currency": 6000,
        "amount": 60
      },
      "strikethrough_price": null,
      "location": {
        "city": "San Antonio",
        "state": "TX",
        "display_name": "Lackland Air Force Base, Texas",
        "city_page_id": "114176668596309"
      },
      "primary_photo": {
        "id": "916476894743958",
        "url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/691721405_916476901410624_3028002815259594366_n.jpg?stp=c0.0.261.261a_dst-jpg_p261x260_tt6&_nc_cat=106&ccb=1-7&_nc_sid=92e707&_nc_ohc=TfPaau7XFP0Q7kNvwEK8N_Q&_nc_oc=AdpR4yQav1U7gbYR9HnvVxKYtFLimvw6kYIhvOQJk8knqZCfuxb1MFiGHbckDI8_Jaw&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=GvS1066o3EBgpWuqL6BQZA&_nc_ss=7e289&oh=00_Af6fFQ1qcqTOTanOUI4cY2B8u6Uhuyl8owgyQKcz3P6TiQ&oe=6A0D44E6"
      },
      "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": "27123216687304592"
    },
    {
      "id": "727510149974761",
      "url": "https://www.facebook.com/marketplace/item/727510149974761/",
      "title": "Like New Ozone 500 Boys’ Blaze 12-Inch Bike – Ridden Less Than 10 Times",
      "creation_time": null,
      "listing_date_text": null,
      "price": {
        "formatted_amount": "$40",
        "amount_with_offset_in_currency": 4000,
        "amount": 40
      },
      "strikethrough_price": null,
      "location": {
        "city": "Austin",
        "state": "TX",
        "display_name": "Austin, Texas",
        "city_page_id": "106224666074625"
      },
      "primary_photo": {
        "id": "735803309595330",
        "url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/605226151_735803329595328_1386149983139267508_n.jpg?stp=c0.0.261.261a_dst-jpg_p261x260_tt6&_nc_cat=110&ccb=1-7&_nc_sid=92e707&_nc_ohc=X9CeUbTefJ8Q7kNvwGQA1xK&_nc_oc=AdrROVW00wzIDti0wdKukd-MIU43VqLwHnqWwclxqki7C-kvzuqEjfquMRANljbmwno&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=GvS1066o3EBgpWuqL6BQZA&_nc_ss=7e289&oh=00_Af4bteQsGq-7ncgAMm5XQOQh6T28wCH7XfeG7QEq1oA8jQ&oe=6A0D6ACA"
      },
      "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": "25785888574376930"
    }
  ],
  "cursor": "eyJwZyI6MCwiYjJj....",
  "has_next_page": true
}

Headers

x-api-key
string
required

Your Scrape Creators API key

Query Parameters

query
string

Search keyword. Required unless category_id is provided.

Example:
bike
lat
number
required

Latitude for the search location

Example:
30.2677
lng
number
required

Longitude for the search location

Example:
-97.7475
category_id
string

Use an ID below to browse without a keyword. Other category IDs require a keyword.

Allowed IDs for keyword-free browsing

  • Antiques:393860164117441
  • Appliances:678754142233400
  • Bicycles:1658310421102081
  • Boats:712638205822882
  • Electronics:1792291877663080
  • Furniture:1583634935226685
  • Garden:800089866739547
  • Household:1569171756675761
  • Tools:1670493229902393
  • Trailers:655837954899686
  • Vehicles:807311116002614
  • Vehicles (alternate ID):546583916084032
Example:
1658310421102081
radius_km
number

Search radius in kilometers

Example:
65
min_price
number

Minimum listing price

Example:
100
max_price
number

Maximum listing price

Example:
500
sort_by
string

Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages.

Example:
creation_time_descend
Available options:
suggested,
distance_ascend,
creation_time_descend,
price_ascend,
price_descend
delivery_method
string

Delivery filter

Example:
local_pickup
Available options:
all,
local_pickup,
shipping
condition
string

Condition filter

Example:
used_good
Available options:
new,
used_like_new,
used_good,
used_fair
date_listed
string

Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last_24_hours can include listings from the prior calendar day.

Example:
7
Available options:
all,
1,
7,
30,
last_24_hours,
last_7_days,
last_30_days
availability
string

Availability filter

Example:
available
Available options:
available,
sold,
all
cursor
string

Opaque pagination cursor returned from the previous response. Pass it back as-is.

Example:
eyJwZyI6MCwiYjJjIjp7...