CaptapiCaptapi
Facebook · Guide

How to run a Facebook marketplace locations

TL;DR
To run a Facebook marketplace locations, sign up for a free Captapi key, then send one GET request to /v1/facebook/marketplace-location-search with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Run a Facebook marketplace locations and get structured, ranked results as clean JSON.
Get your free API keyAPI reference

How to run a Facebook marketplace locations (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Facebook Marketplace Location Search API

    Send an authenticated GET request to /v1/facebook/marketplace-location-search with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/facebook/marketplace-location-search?q=Austin%2C%20TX" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "query": "Austin, TX",
    "totalReturned": 1,
    "locations": [
      {
        "id": "austin, tx|austin|tx",
        "name": "Austin, TX",
        "city": "Austin",
        "state": "TX",
        "latitude": 30.2677,
        "longitude": -97.7475
      }
    ]
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
qstring YesCity/place search query, e.g. Austin.
limitintegerNoMax items to return (default 10, max 50). Flat 2 credits per call.
detailsbooleanNoLegacy flag. Coordinates are included when available. Flat 2 credits either way.
cachebooleanNoSet true to serve from the 24h response cache. Default false — always fetch fresh data.

Frequently asked questions

What does the Facebook Marketplace Location Search API do?

The Facebook Marketplace Location Search API lets you search and return matching results from a public Facebook query using one GET request to /v1/facebook/marketplace-location-search. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Facebook Marketplace Location Search API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Failed or empty results are never charged.

Do I need a Facebook API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Facebook Marketplace Location Search API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to run a Facebook marketplace locations?

Start free with 100 credits — no credit card required.

Get your free API key