FACEBOOK MARKETPLACE API
Marketplace Item
Retrieve marketplace item from Facebook Marketplace with a single API request.
GET
/api/data/v1/facebook/marketplace/item1credit base cost
Request parameters
Up to 1 creditFacebook Marketplace item id
Facebook Marketplace item URL
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/facebook/marketplace/item?id=1656586118821988' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"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 person. Come ride it! These never last long. \n\nCASH ONLY, PLEASE. NEAR 183/BRAKER. \n\n$380 OBO. \n\nKey points:\n\n- Maxxis DTH tires (26”)\n- Shimano Deore XT rear derailleur \n- Shimano front derailleur\n- vintage Specialized steel frame (20”)\n- vintage Sakae triple crankset (170mm)\n- vintage Sakae SR Custom handlebar\n- vintage Suntour stem shifter\n- vintage Shimano brakes\n- Specialized Avatar 143 saddle\n- new chain\n- fresh cables\n- fresh housing\n- fresh grease and",
"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--Ur89Efziu4LbR01Gx7vv7Ky2iQDaspacjs93wQf7O21Zucf8Bqk7JnAV9us&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=I5XX4xnX65bx3IZ1QXZ0oQ&_nc_ss=7e289&oh=00_Af4qBsmM1VtSMQvu_Uq9lP5B3sZDkmH3d7tcnkb4qJrfvQ&oe=6A0D43D6",
"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,
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Example data from the API specification. Run a request to retrieve current data.
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"
},
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"creation_time": {
"type": "string"
},
"listing_date_text": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"availability_text": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"location_text": {
"type": "string"
},
"location": {
"type": "object",
"properties": {
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
}
}
},
"price": {
"type": "object",
"properties": {
"formatted_amount_zeros_stripped": {
"type": "string"
},
"amount_with_offset_in_currency": {
"type": "integer"
},
"amount": {
"type": "integer"
},
"currency": {
"type": "string"
}
}
},
"strikethrough_price": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"category_id": {
"type": "string"
},
"attributes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"attribute_name": {
"type": "string"
},
"value": {
"type": "string"
},
"label": {
"type": "string"
}
}
}
},
"photos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"accessibility_caption": {
"type": "string"
}
}
}
},
"is_hidden": {
"type": "boolean"
},
"is_live": {
"type": "boolean"
},
"is_pending": {
"type": "boolean"
},
"is_sold": {
"type": "boolean"
},
"is_viewer_seller": {
"type": "boolean"
},
"is_shipping_offered": {
"type": "boolean"
},
"is_buy_now_enabled": {
"type": "boolean"
},
"messaging_enabled": {
"type": "boolean"
},
"delivery_types": {
"type": "array",
"items": {
"type": "string"
}
},
"share_uri": {
"type": "string"
},
"seller": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"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."
}
}
}