Facebook Marketplace API
Resolve places into search coordinates, discover public Marketplace listings by keyword and location, or retrieve detailed price, seller, media, attribute, and availability data from known item URLs.
Available Facebook Marketplace APIs
Use Location Search to resolve a place, Search to discover listings around coordinates, or Item to retrieve detailed records from known Marketplace item URLs.
What Facebook Marketplace data can you retrieve?
SocQ returns normalized public location candidates, listing search results, and item details for local market research, price analysis, inventory tracking, and listing enrichment.
Marketplace location candidates
Resolve a city, region, neighborhood, or place name into Facebook location IDs, labels, address context, latitude, and longitude.
Public listing identity
Retrieve listing IDs, titles, descriptions, source URLs, categories, listing-date text, and collection timestamps when available.
Prices and currencies
Keep available price amounts, currency codes, formatted prices, and strikethrough prices with each normalized listing.
Location and delivery data
Retrieve available place labels, city and state values, coordinates, delivery types, shipping signals, and pickup context.
Media, attributes, and seller context
Collect public listing images, item attributes, condition values, and seller identity fields when the source exposes them.
Availability and listing state
Keep available, sold, pending, hidden, live, messaging, and buy-now signals for point-in-time listing analysis.
SocQ vs Meta Graph API
SocQ focuses on supported public Marketplace collection. Meta's Graph API is designed for authorized Meta assets and does not provide a general public Marketplace search API.
| Capability | SocQ | Meta Graph API |
|---|---|---|
| Primary use | Public Marketplace location, search and item collection | Manage supported assets that a user or business has authorized |
| Customer OAuth | SocQ API key; no customer Facebook OAuth | Meta app, permissions and access tokens |
| Public listing search | Supported with a keyword and resolved location | No general public Marketplace listing search endpoint |
| Create or edit listings | Not supported | No general consumer Marketplace publishing endpoint |
| Response format | Normalized SocQ records | Native Graph API objects for supported products |
How the Facebook Marketplace API works
Resolve a search center when needed, submit a listing search or known item URL, then read normalized records through the shared asynchronous task flow.
1. Prepare the starting input
Resolve a place name into coordinates, use coordinates you already know, or start directly from a public Marketplace item URL.
2. Submit and track the task
Send the matching POST request, save the returned task_id, and poll /v1/tasks/{task_id} until processing finishes.
3. Read the normalized results
Process data.results.items and follow next_cursor while has_more is true.
Resolve a place name first, then use the selected candidate's coordinates to search public Marketplace listings.
# Resolve a place name
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/location-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Austin"}'
# Search listings around the selected coordinates
curl -X POST "https://api.socq.ai/v1/facebook-marketplace/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"bike","latitude":30.2677,"longitude":-97.7475,"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCommon Facebook Marketplace API use cases
Local listing discovery
Resolve a market area and search public listings by keyword, coordinates, radius, price, condition, delivery method, date, or availability.
Local price comparison
Compare normalized asking prices, currencies, titles, categories, conditions, and locations for similar public listings.
Regional inventory monitoring
Collect bounded listing snapshots for selected markets and compare public inventory, delivery options, and availability over time.
Known listing enrichment
Turn known item URLs into detailed records with descriptions, seller context, prices, locations, media, attributes, and state fields.
Limits and public-data policy
Marketplace results are point-in-time public records. These APIs do not reproduce the consumer Marketplace interface or manage listings and accounts.
- Location Search requires one non-empty place-name query, does not accept results_limit, and can return several similarly named candidates.
- Verify address context and coordinates before using a location candidate as the center of a listing search.
- Search requires a non-empty keyword, latitude, and longitude; results_limit defaults to 100 and accepts integers from 1 through 2,000.
- Search results can omit descriptions, seller details, precise coordinates, attributes, and creation times, and duplicate listing IDs are saved once.
- Item requires supported /marketplace/item/{numeric_id} URLs; each valid URL returns at most one record and unavailable items can be skipped.
- An empty result can reflect no public match, restrictive filters, regional availability, an unavailable listing, or a public-source boundary.
Facebook Marketplace API frequently asked questions
What is the Facebook Marketplace API?
The Facebook Marketplace API is a set of SocQ endpoints for resolving Marketplace locations, searching public listings, and retrieving detailed records from known item URLs.
Which Facebook Marketplace API should I use?
Use Location Search to resolve a place, Search to discover listings around coordinates, and Item when you already have public Marketplace item URLs.
How do I search Facebook Marketplace by location?
Submit a city, region, neighborhood, or place name to Location Search, select the correct candidate, then pass its latitude and longitude to Search.
What does Facebook Marketplace Search return?
Search can return listing identity, title, description, price, location, images, seller context, category, delivery options, state fields, source URL, and collection time.
When should I use Facebook Marketplace Item?
Use Item for known public item URLs when you need detailed description, seller, price, location, media, attributes, delivery, and availability fields.
Why can the result count be lower than results_limit?
The limit is a requested maximum. Collection can stop when no additional public page is available, filters exclude records, or duplicate listing IDs are removed.
How are Facebook Marketplace results priced?
Location candidates cost 0.3 credits, Search listings cost 0.7 credits, and Item records cost 0.6 credits per returned result. Empty results have no result charge.