> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Item
> Fetch full details for a single Facebook Marketplace listing by its ID or URL.
💳 **1 credit** per request
Pass either the listing `id` or its full Marketplace `url` — you only need
one.
## OpenAPI
````yaml GET /v1/scrape/facebook-marketplace/item
openapi: 3.1.0
info:
title: SociaVault API
version: 1.0.0
description: >-
# SociaVault API Documentation
The SociaVault API provides comprehensive access to social media data
extraction across multiple platforms.
## Features
- **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
Reddit, Threads, and more
- **Credit-Based System**: Pay-as-you-go pricing with transparent credit
costs
- **High Performance**: Fast, reliable data extraction
- **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
and analytics
## Authentication
All API requests require authentication using an API key in the `X-API-Key`
header:
```bash
X-API-Key: sk_live_your_api_key_here
```
Get your API key from the [SociaVault
Dashboard](https://sociavault.com/dashboard).
## Credits
Each endpoint consumes credits based on data complexity:
- Simple requests (profiles): 1 credit
- Complex requests (demographics): 20+ credits
- Paginated requests: Credits per page
Check your credit balance in the dashboard or via the API.
## Support
- **Documentation**: https://docs.sociavault.com
- **Email**: support@sociavault.com
- **Discord**: https://discord.gg/sociavault
contact:
name: SociaVault Support
email: support@sociavault.com
url: https://sociavault.com/support
license:
name: Commercial
url: https://sociavault.com/terms
servers:
- url: https://api.sociavault.com
description: Production API
security:
- ApiKeyAuth: []
tags:
- name: account
description: Account management and credit balance
externalDocs:
description: Learn more
url: https://docs.sociavault.com/account
- name: tiktok
description: Scrape TikTok profiles, videos, and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/tiktok
- name: tiktok-shop
description: Everything about TikTok Shop
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/tiktok-shop
- name: instagram
description: Gets Instagram profiles, posts, and reels
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/instagram
- name: youtube
description: Scrape YouTube channels, videos, and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/youtube
- name: linkedin
description: Scrape LinkedIn
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/linkedin
- name: facebook
description: Get public Facebook profiles and posts
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebook
- name: facebookAdLibrary
description: Scrapes the Facebook (Meta) Ad Library
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebookAdLibrary
- name: facebookMarketplace
description: Search Facebook Marketplace and pull full listing details
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebookMarketplace
- name: googleAdLibrary
description: >-
Scrape the Google Ad Transparency Library. *This only gets the public ads.
Some ads you need to log in for and sadly we can't get those. Also, since
there are so many variations, the return types might not all be 100% the
same.
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/googleAdLibrary
- name: linkedinAdLibrary
description: Search the LinkedIn Ad Library
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/linkedinAdLibrary
- name: twitter
description: Get Twitter profiles, tweets, followers and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/twitter
- name: reddit
description: Scrape Reddit posts and comments
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/reddit
- name: threads
description: Get Threads posts
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/threads
- name: google
description: Scrape Google search results
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/google
paths:
/v1/scrape/facebook-marketplace/item:
get:
tags:
- facebookMarketplace
summary: Item
description: >-
Fetch full details for a single Facebook Marketplace listing by its ID
or URL.
operationId: facebookMarketplace_Item
parameters:
- name: id
in: query
description: Facebook Marketplace item id (use id or url)
required: false
schema:
type: string
example: '1656586118821988'
- name: url
in: query
description: Facebook Marketplace item URL (use id or url)
required: false
schema:
type: string
example: https://www.facebook.com/marketplace/item/1656586118821988/
responses:
'200':
description: >-
Successful response
**Key Response Fields:**
- `data.id`: Marketplace listing identifier
- `data.url` / `share_uri`: Direct link to the listing on Facebook
- `data.title`: Listing title
- `data.description`: Full listing description text
- `data.creation_time`: ISO 8601 timestamp of when the listing was
posted
- `data.location_text`: Human-readable location (e.g. `"London,
United Kingdom"`)
- `data.location.latitude` / `longitude`: Precise coordinates of the
listing
- `data.price.amount`: Numeric price value
- `data.price.formatted_amount_zeros_stripped`: Display price string
(e.g. `"£5"`)
- `data.price.currency`: ISO currency code (e.g. `"GBP"`)
- `data.strikethrough_price`: Original price before discount, or
`null`
- `data.attributes[0].attribute_name` / `value` / `label`: Item
attributes such as condition
- `data.photos[0].url` / `width` / `height`: Listing photos array
- `data.is_sold` / `is_live` / `is_pending`: Listing status flags
- `data.delivery_types`: Available delivery methods (e.g.
`IN_PERSON`)
- `data.seller`: Seller profile info, or `null` if not available
content:
application/json:
example:
success: true
data:
success: true
id: '1278061654412635'
url: https://www.facebook.com/marketplace/item/1278061654412635/
title: Formal shoes
description: Formal shoes used only once... size UK12.
creation_time: '2026-05-15T12:03:51.000Z'
location_text: London, United Kingdom
location:
latitude: 51.512145996094
longitude: -0.1043701171875
price:
formatted_amount_zeros_stripped: £5
amount_with_offset_in_currency: 664
amount: 5
currency: GBP
strikethrough_price: null
category_id: '931157863635831'
attributes:
'0':
attribute_name: Condition
value: used_good
label: Used - Good
photos:
'0':
id: '1889521335087397'
url: >-
https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/699132406_1889521345087396_1900687902739816956_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=100&ccb=1-7&_nc_sid=92e707&_nc_ohc=NWY0ouwhkyQQ7kNvwGUburJ&_nc_oc=AdpP5K8nFbn_rxoPMSXKdTEVvU1yrohGJKsqNDAottRhGa-cPQ6wfuJe1lCckE0lr-U&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af6NoRpfi6Xah2sym375Rc5xGJN_rizevUTsMxgfhuI2Tg&oe=6A0E0F17
width: 443
height: 960
accessibility_caption: No photo description available.
'1':
id: '1741302177009337'
url: >-
https://scontent-bos5-1.xx.fbcdn.net/v/t45.5328-4/696698524_1741302180342670_8753490698983285357_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=102&ccb=1-7&_nc_sid=247b10&_nc_ohc=jxxu6gpPe48Q7kNvwEl_RH6&_nc_oc=AdrbNL5_6KB9YhiGwae5FkjfSSXGSSo6ixBpvsdyCau6CsbdeeuOPMXkpAFBCbrLPho&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af7MenQudv2cM5fkdLAcMNOEinrZudbev0-BhBQH0NVemA&oe=6A0E005B
width: 443
height: 960
accessibility_caption: No photo description available.
'2':
id: '957534360394038'
url: >-
https://scontent-bos5-1.xx.fbcdn.net/v/t45.5328-4/697158330_957534363727371_710797950200649114_n.jpg?stp=dst-jpg_s960x960_tt6&_nc_cat=106&ccb=1-7&_nc_sid=247b10&_nc_ohc=so2agAzsOFAQ7kNvwFeon1g&_nc_oc=AdrE4yXI0FK8NmWDN1Vuyb83xiejDRVe7saS2GOy8mamOxS3h4-Y-GntfunxB16ERjk&_nc_zt=23&_nc_ht=scontent-bos5-1.xx&_nc_gid=FYxxqOqNnr7L-aCsjjIJSA&_nc_ss=7e289&oh=00_Af7gJvnYvAF6a6IivkKXfZpqNE4jgLZys2N3Sw7xh0ThQQ&oe=6A0E12FC
width: 443
height: 960
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:
'0': IN_PERSON
share_uri: https://www.facebook.com/marketplace/item/1278061654412635/
seller: null
creditsUsed: 1
'400':
description: Bad Request - Invalid parameters or missing required fields
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Either Marketplace item id or url parameter is required
endpoint:
type: string
credits_required:
type: integer
required:
- error
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid API key
docs:
type: string
example: https://docs.sociavault.com/authentication
required:
- error
'402':
description: Payment Required - Insufficient credits
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Insufficient credits
required:
type: integer
example: 1
description: Credits required for this request
available:
type: integer
example: 0
description: Credits currently available
required:
- error
- required
- available
'500':
description: Internal Server Error - Service configuration or processing error
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Service configuration error
required:
- error
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: |-
API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
Get your API key from the [Dashboard](https://sociavault.com/dashboard).
````