Sourcelane

Facebook Marketplace Scraper

E-commerce & Marketplaces

Operated by Sourcelane✓ verified

A scraper and search tool for Facebook Marketplace that finds listings by keyword and location (including coordinates) and extracts structured listing metadata and optional full-item details: titles, prices (numeric value and currency, including original/strikethrough prices), location (city/state and display name, plus GPS coordinates when enabled), primary photo and photo gallery, item condition and attribute lists (brand, size, model, etc.), delivery options, sold/pending flags, listing date, and seller information. The connector supports filters for price range, condition, date listed, delivery method, availability, sort order, and search radius, offers a pagination cursor for fetching large result sets across chained runs, and can fetch full details with an extra request per listing.

Verified Sep 28, 12:10 AM

$0.002

per marketplace listing

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Trust & reliability

7d uptime trend
WindowUptimeSuccess ratep50p95Calls
24h————0
7d————0
30d————0

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"facebook-marketplace-scraper","params":{"query":"bike","location":"Austin, Texas","maxItems":5},"maxResults":10}'

Request params

FieldTypeRequiredDescription
querystringrequiredWhat to search for on Facebook Marketplace, e.g. 'road bike', 'sofa', 'iPhone 15'.
locationstringrequiredCity to search around, e.g. 'Austin, Texas' or 'Sydney'. You can also pass exact coordinates as 'lat,lng' (e.g. '30.2677,-97.7475').
radiusKmintegeroptionalSearch radius around the location, in kilometers.
minPriceintegeroptionalOnly return listings priced at or above this amount (in the local currency).
maxPriceintegeroptionalOnly return listings priced at or below this amount (in the local currency).
sortBystringoptionalHow to order the search results.
conditionstringoptionalFilter listings by item condition.
dateListedstringoptionalOnly return listings created within this time window.
deliveryMethodstringoptionalFilter by how the item can be delivered.
availabilitystringoptionalWhether to include available listings, sold listings, or both.
maxItemsintegeroptionalMaximum number of listings to return in this run. Set 0 for unlimited (until the search is exhausted or the run times out). Capped at 100 per call.
itemDetailsbooleanoptionalWhen enabled, each listing is enriched with the full description, exact GPS coordinates, condition, attributes, all photos, and seller info. Slower and uses one extra request per listing.
pageIdstringoptionalPaste NEXT_PAGE_ID from the previous run's Key-value store to fetch the next page of results.

Each result contains

FieldTypeDescription
idstringId
urlstringUrl
titlestringTitle
pricestringPrice
priceAmountintegerPrice Amount
currencynullCurrency
originalPricenullOriginal Price
citystringCity
statestringState
locationDisplayNamestringLocation Display Name
photoUrlstringPhoto Url
categoryIdstringCategory Id
isSoldboolean—
isPendingboolean—
deliveryTypesarray—
descriptionnull—
creationTimenull—
listingDateTextnull—
availabilityTextnull—
latitudenull—
longitudenull—
conditionnull—
attributesnull—
photosnull—
sellernull—

Use Facebook Marketplace Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “Track the price of these 20 grocery items at Woolworths and Coles every week.”

Connect Claude

Web, desktop and mobile. Paste one URL.

  1. 1Copy your personal connector URL
  2. 2In Claude open Settings → Connectors → Add custom connector
  3. 3Paste the URL and click Add — done
Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal
claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json
{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json
{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json
{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL
https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl
curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"facebook-marketplace-scraper","params":{"query":"bike","location":"Austin, Texas","maxItems":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python
import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "facebook-marketplace-scraper",
        "params": {"query":"bike","location":"Austin, Texas","maxItems":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

5
0
4
0
3
0
2
0
1
0

Leave a review

Loading reviews…