social data api

Facebook Marketplace

Location lookup, listing search and listing details.

Find a Marketplace location	`/v1/facebook/marketplace/location/search`	1 request
Search listings	`/v1/facebook/marketplace/search`	1 request
Listing details	`/v1/facebook/marketplace/item`	1 request

GET/v1/facebook/marketplace/location/search

Searches Facebook Marketplace listings for a keyword around a lat/lng point. Listings expose creation_time (ISO 8601, UTC) only if Facebook reveals the exact time the item was listed, and listing_date_text when available; either may be null. Use category_id to limit results to one numeric Marketplace category, as reported on each listing. Paginate by sending back the returned cursor unchanged. Even with sort_by=creation_time_descend, Facebook may order identical requests slightly differently, so for new-item alerts fetch several pages and deduplicate on listing id rather than trusting the first page to be stable.

Query parameters

`query` stringrequired	Keyword to search for.
`category_id` string	Numeric Marketplace category ID, as returned in `category_id` on listings.
`lat` numberrequired	Latitude of the search center.
`lng` numberrequired	Longitude of the search center.
`radius_km` number	Search radius in kilometers.
`min_price` number	Lowest listing price to include.
`max_price` number	Highest listing price to include.
`count` number	How many listings to return.
`sort_by` string	Result ordering. `suggesteddistance_ascendcreation_time_descendprice_ascendprice_descend`
`delivery_method` string	Filter by pickup, shipping, or both. `alllocal_pickupshipping`
`condition` string	Filter by item condition. `newused_like_newused_goodused_fair`
`date_listed` string	Filter by how recently the item was listed. `all1730last_24_hourslast_7_dayslast_30_days`
`availability` string	Filter by available, sold, or all listings. `availablesoldall`
`cursor` string	Opaque cursor from the previous response; send it back unchanged.

curl "https://api.pandorlabs.com/v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "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=AdomRHPRV49gouEOWqxlFxu…"
      },
      "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": "26881002338175809"
    }
  ],
  "cursor": "eyJwZyI6MCwiYjJj....",
  "has_next_page": true
}

GET/v1/facebook/marketplace/item

Listing details

1 request

Returns a single Facebook Marketplace item, looked up by item id or listing URL. The response includes the title, price, description, condition, location, seller, photos, and flags describing whether the item is available. Rental listings may also carry listing_date_text and availability_text taken from Facebook's Marketplace GraphQL data, such as 'Listed over a week ago' or 'Available now'. creation_time is null whenever Facebook does not reveal an exact timestamp.

Query parameters

`id` string	Marketplace item id.
`url` string	Link to the Marketplace item.

curl "https://api.pandorlabs.com/v1/facebook/marketplace/item" \  -H "Authorization: Bearer $PANDORLABS_KEY"

Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "id": "1656586118821988",
  "url": "https://www.facebook.com/marketplace/item/1656586118821988/",
  "title": "Specialized Hardrock GSX - Super Clean Vintage Restomod - INCLUDES FREE TUNE UP",
  "description": "Was going to hang on to this one bc I absolutely love how it looks, but the 20” frame is just bit too large for me. Riders over 6’ would be comfy on this one. Currently in a 3x7 set up with an XT derailleur at the rear. Looks great in perso…",
  "creation_time": "2026-05-15T16:57:39.000Z",
  "listing_date_text": null,
  "availability_text": null,
  "location_text": "Austin, TX",
  "location": {
    "latitude": 30.401916503906,
    "longitude": -97.761840820312
  },
  "price": {
    "formatted_amount_zeros_stripped": "$380",
    "amount_with_offset_in_currency": 38000,
    "amount": 380,
    "currency": "USD"
  },
  "strikethrough_price": null,
  "category_id": "1658310421102081",
  "attributes": [
    {
      "attribute_name": "Condition",
      "value": "used_good",
      "label": "Used - Good"
    }
  ],
  "photos": [
    {
      "id": "2810586442651711",
      "url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/701290950_2810586459318376_3780262866029042186_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=111&ccb=1-7&_nc_sid=92e707&_nc_ohc=ROKufyRtfXsQ7kNvwGcXi_k&_nc_oc=Adr-1I--Ur89Efziu4LbR01Gx7vv7Ky2iQDas…",
      "width": 960,
      "height": 720,
      "accessibility_caption": "No photo description available."
    }
  ],
  "is_hidden": false,
  "is_live": true,
  "is_pending": false,
  "is_sold": false,
  "is_viewer_seller": false,
  "is_shipping_offered": false,
  "is_buy_now_enabled": false,
  "messaging_enabled": true,
  "delivery_types": [
    "IN_PERSON"
  ],
  "share_uri": "https://www.facebook.com/marketplace/item/1656586118821988/",
  "seller": null
}

Find a Marketplace location

Query parameters

Search listings

Query parameters

Listing details

Query parameters