Marketplace Search
Retrieve marketplace search from Facebook Marketplace with a single API request.
/api/data/v1/facebook/marketplace/searchRequest parameters
Up to 1 creditSearch keyword
Numeric Facebook Marketplace category ID. Listing results include this value as category_id.
Latitude for the search location
Longitude for the search location
Search radius in kilometers
Minimum listing price
Maximum listing price
Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages.
Delivery filter
Condition filter
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.
Availability filter
Opaque pagination cursor returned from the previous response. Pass it back as-is.
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/facebook/marketplace/search?query=bike&lat=30.2677&lng=-97.7475' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"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"
],
"story_type": "POST",
"story_key": "26881002338175809"
}
],
"cursor": "eyJwZyI6MCwiYjJj....",
"has_next_page": true,
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"creation_time": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"listing_date_text": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"price": {
"type": "object",
"properties": {
"formatted_amount": {
"type": "string"
},
"amount_with_offset_in_currency": {
"type": "integer"
},
"amount": {
"type": "integer"
}
}
},
"strikethrough_price": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"location": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"display_name": {
"type": "string"
},
"city_page_id": {
"type": "string"
}
}
},
"primary_photo": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
}
}
},
"category_id": {
"type": "string"
},
"is_hidden": {
"type": "boolean"
},
"is_live": {
"type": "boolean"
},
"is_pending": {
"type": "boolean"
},
"is_sold": {
"type": "boolean"
},
"is_viewer_seller": {
"type": "boolean"
},
"delivery_types": {
"type": "array",
"items": {
"type": "string"
}
},
"story_type": {
"type": "string"
},
"story_key": {
"type": "string"
}
}
}
},
"cursor": {
"type": "string"
},
"has_next_page": {
"type": "boolean"
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}