> ## 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.
# Search
> Pull Facebook Marketplace listings around any coordinate, with filters for price range, condition, delivery method, listing date, and availability. Use the Location Search endpoint first to grab the lat/lng for the city or region you want to search.
💳 **1 credit** per request
Need a `lat` / `lng` for a city? Run [Location
Search](/api-reference/facebook-marketplace/location-search) first to grab
them.
## OpenAPI
````yaml GET /v1/scrape/facebook-marketplace/search
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/search:
get:
tags:
- facebookMarketplace
summary: Search
description: >-
Pull Facebook Marketplace listings around any coordinate, with filters
for price range, condition, delivery method, listing date, and
availability. Use the Location Search endpoint first to grab the lat/lng
for the city or region you want to search.
operationId: facebookMarketplace_Search
parameters:
- name: query
in: query
description: Search keyword
required: true
schema:
type: string
example: bike
- name: lat
in: query
description: Latitude for the search location
required: true
schema:
type: number
example: 30.2677
- name: lng
in: query
description: Longitude for the search location
required: true
schema:
type: number
example: -97.7475
- name: radius_km
in: query
description: Search radius in kilometers
required: false
schema:
type: number
example: 65
- name: min_price
in: query
description: Minimum listing price
required: false
schema:
type: number
example: 100
- name: max_price
in: query
description: Maximum listing price
required: false
schema:
type: number
example: 500
- name: count
in: query
description: Number of listings to return
required: false
schema:
type: integer
example: 24
- name: sort_by
in: query
description: Sort order
required: false
schema:
type: string
enum:
- suggested
- distance_ascend
- creation_time_descend
- price_ascend
- price_descend
example: creation_time_descend
- name: delivery_method
in: query
description: Delivery filter
required: false
schema:
type: string
enum:
- all
- local_pickup
- shipping
example: local_pickup
- name: condition
in: query
description: Condition filter
required: false
schema:
type: string
enum:
- new
- used_like_new
- used_good
- used_fair
example: used_good
- name: date_listed
in: query
description: Date listed filter
required: false
schema:
type: string
enum:
- all
- '1'
- '7'
- '30'
- last_24_hours
- last_7_days
- last_30_days
example: '7'
- name: availability
in: query
description: Availability filter
required: false
schema:
type: string
enum:
- available
- sold
- all
example: available
- name: cursor
in: query
description: >-
Opaque pagination cursor returned from the previous response. Pass
it back as-is.
required: false
schema:
type: string
example: eyJwZyI6MCwiYjJjIjp7...
responses:
'200':
description: >-
Successful response
**Key Response Fields:**
- `data.listings[0].id`: Marketplace listing identifier
- `data.listings[0].url`: Direct link to the listing on Facebook
- `data.listings[0].title`: Listing title
- `data.listings[0].price.amount`: Numeric price value
- `data.listings[0].price.formatted_amount`: Display price string
(e.g. `"£50"`)
- `data.listings[0].strikethrough_price`: Original price before
discount, or `null`
- `data.listings[0].location.city` / `display_name`: Listing
location
- `data.listings[0].primary_photo.url`: Primary listing image URL
- `data.listings[0].is_sold`: Whether the item has been sold
- `data.listings[0].delivery_types`: Available delivery methods
(e.g. `IN_PERSON`)
- `data.cursor`: Opaque token — pass back as `cursor` to get the
next page
- `data.has_next_page`: Whether more results are available
content:
application/json:
example:
success: true
data:
success: true
listings:
'0':
id: '1278061654412635'
url: >-
https://www.facebook.com/marketplace/item/1278061654412635/
title: Formal shoes
price:
formatted_amount: £5
amount_with_offset_in_currency: 664
amount: 5
strikethrough_price: null
location:
city: London
state: ''
display_name: London, United Kingdom
city_page_id: '106078429431815'
primary_photo:
id: '1889521335087397'
url: >-
https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/699132406_1889521345087396_1900687902739816956_n.jpg?stp=c0.152.261.261a_dst-jpg_p261x260_tt6&_nc_cat=100&ccb=1-7&_nc_sid=92e707&_nc_ohc=NWY0ouwhkyQQ7kNvwGI0BWd&_nc_oc=Adq9qpn3lo9d2KMtr2t-D6lxjK1AyLgoHfU65OWizxABrY-S_cKglWICAZ7b0ovFy38&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=6EURlaJdwNM2kdycJisnRQ&_nc_ss=7e289&oh=00_Af6kELa3QVtHFxpoUtifE35b25rO0uUhdH9SGWZTFmK38Q&oe=6A0E0F17
category_id: '931157863635831'
is_hidden: false
is_live: true
is_pending: false
is_sold: false
is_viewer_seller: false
delivery_types:
'0': IN_PERSON
story_type: POST
story_key: '27606522242281795'
'1':
id: '1007407098904810'
url: >-
https://www.facebook.com/marketplace/item/1007407098904810/
title: Brand New Shoes
price:
formatted_amount: £50
amount_with_offset_in_currency: 6635
amount: 50
strikethrough_price:
formatted_amount: £150
amount: '150.00'
location:
city: Ramsgate
state: ''
display_name: Ramsgate
city_page_id: '109305879096299'
primary_photo:
id: '2002571970350599'
url: >-
https://scontent-bos5-1.xx.fbcdn.net/v/t39.84726-6/687423731_2002571990350597_2633826128463830451_n.jpg?stp=c2.0.260.260a_dst-jpg_p261x260_tt6&_nc_cat=110&ccb=1-7&_nc_sid=92e707&_nc_ohc=0jZJ-bEvR7MQ7kNvwGaYZfs&_nc_oc=Adqw78SK-QX0EP47cS61vx7hLgHC-dRgCLKSzVI4O-Xu1J0x3jSpTQ-LAlib2BBEkp8&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=6EURlaJdwNM2kdycJisnRQ&_nc_ss=7e289&oh=00_Af7m_GN1ztl94aNh6myqlCX2OyhX05GSZt80J7hOK8gTyw&oe=6A0E241A
category_id: '931157863635831'
is_hidden: false
is_live: true
is_pending: false
is_sold: false
is_viewer_seller: false
delivery_types:
'0': IN_PERSON
story_type: POST
story_key: '26023461383999344'
cursor: >-
eyJwZyI6MCwiYjJjIjp7ImJyIjoiIiwiaXQiOjAsImhtc3IiOmZhbHNlLCJ0YmkiOjB9LCJjMmMiOnsiYnIiOiJBYnJmZHBFOTA4eEtJczVGR09oRDg4NWpfMldFdUpsdXUtU2Z5dVd5M1FSTVN6TVRnbHR6MkxqbEFGOVF1YVlQZFdkNzMxQWg0OWd4d3VseWhULXgzSG5SSGNBUWkxVWZ0QTNHZDR5Nm5JbmhRb3pSNGNyU3JuRHpyamNGVjlZWGp2czd0RjdiVExIWFhqazV2SU5XX3VDbXEzZ09SSVVLb1ZGMHNmWVdab2NIZXlUbzRYX1JWSXV0NVFGb2xqYWhjN3Jyd3VOdHExSFNEaXd2OWJ1aVhURzhQcjBFcVRjZG5zNUt0X0pSTEprNWgxN20zX2g3UDluemlVaVVSVlBCWVkxR2RBNXNtVDNrSG5EX1Q3bzBEejVhTnlERThZVkxZQkhjcGw0YndPeHl3ako0R044VjlDM1NsU2ZuZjI1cktYdFVKR0RrT3BoSXNFOWhJeWUyYXZ0ZV8yTTlQaUJsRFd3aWVwWS1OeEl1RFhlNFJIVzBudVFxRTF5dURfSnkxT1NZZXRySS1ZN1prZnBTV2lSajlja1I5a1NPbW5SRUFtN2g1c2RXTENvZHZndE53ejdMbWJRbHh3VmpSejBHNDNvODlJUng2dmxoNmtDcnVRZi0xdEVrbFFQRFVKMmVRT3VoUV9nUlRHY2JHdmRPSmsyVGtTU0s5dDRUekdzdUh3M2FuT1V5NzlnTmpLQnN3S0JHQzlaelVDM0NKem55QVg0alQ4UVRHUzZtV3NnX0tIQ1Bma3RoQXdyS3VHeEFvTTQiLCJpdCI6MCwicnBiciI6IiIsInJwaHIiOmZhbHNlLCJybWhyIjpmYWxzZSwic3NpIjpmYWxzZSwic3NjbyI6MCwic3NwaSI6W119LCJpcnIiOmZhbHNlLCJzZXJwX2N0YSI6ZmFsc2UsInJ1aSI6W10sIm1waWQiOltdLCJ1YnAiOm51bGwsIm5jcm5kIjowLCJpcnNyIjpmYWxzZSwiYm1wciI6W10sImJtcGVpZCI6W10sIm5tYm1wIjpmYWxzZSwic2tyciI6ZmFsc2UsImlvb3VyIjpmYWxzZSwiaXNlIjpmYWxzZSwic21zX2N1cnNvciI6eyJwYWdlX2luZGV4IjowLCJibGVuZGVkX2FkX2luZGV4IjowLCJvcmdhbmljc19zaW5jZV9sYXN0X2FkIjowLCJwYWdlX29yZ2FuaWNfY291bnQiOjAsImJsZW5kZWRfb3JnYW5pY19pbmRleCI6MCwicmV0dXJuZWRfYWRfaW5kZXgiOjAsInRvdGFsX2luZGV4IjowfX0
has_next_page: true
creditsUsed: 1
'400':
description: Bad Request - Invalid parameters or missing required fields
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: lat is required and must be a number
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).
````