How to scrape Facebook Marketplace Search with Kotlin

Marketplace Search This tutorial gets it with a short Kotlin program and the Facebook Marketplace Search API. Each successful call costs 1 credit; errors and not-found answers are free.

1. Get an API key

Sign in to get a key and 100 free credits, no card. Then put the key in an environment variable so it stays out of your code:

export SCRAPEIO_API_KEY="your_key_here"

2. Set up Kotlin

Kotlin on JVM 11 or newer

3. Write the code

Save this as Scrape.kt. Replace YOUR_LAT with a real lat, YOUR_LNG with a real lng.

import java.net.URI
import java.net.URLEncoder
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse

fun main() {
    val params = mapOf("lat" to "YOUR_LAT", "lng" to "YOUR_LNG")
    val query = params.entries.joinToString("&") { "${it.key}=${URLEncoder.encode(it.value, Charsets.UTF_8)}" }
    val req = HttpRequest.newBuilder()
        .uri(URI.create("https://scrapeio.com/v1/facebook/marketplace/search?" + query))
        .header("x-api-key", System.getenv("SCRAPEIO_API_KEY"))
        .build()
    val res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString())
    check(res.statusCode() == 200) { "HTTP ${res.statusCode()}" }
    println(res.body())
}

This prints the first page. To get the next one, send the value of data.cursor as the cursor parameter and call again until data.has_more is false.

4. Run it

kotlinc Scrape.kt -include-runtime -d scrape.jar && java -jar scrape.jar

The response has the same envelope on every endpoint: success, cached, credits_used, credits_remaining and data. Shared fields such as handle, followers, plays, likes and created_at have the same names on every platform.

Parameters

Name	Type	Description
`query`	string	Search keyword.
`lat` (required)	string	Latitude for the search location
`lng` (required)	string	Longitude for the search location
`category_id`	string	Category ID from listing results.
`radius_km`	string	Search radius in kilometers
`min_price`	string	Minimum listing price
`max_price`	string	Maximum listing price
`sort_by`	suggested, distance_ascend, creation_time_descend, price_ascend, price_descend	Facebook Marketplace sort option.
`delivery_method`	all, local_pickup, shipping	Delivery filter
`condition`	new, used_like_new, used_good, used_fair	Condition filter
`date_listed`	all, 1, 7, 30, last_24_hours, last_7_days, last_30_days	Facebook Marketplace date filter.
`availability`	available, sold, all	Availability filter
`cursor`	string	Opaque pagination cursor returned from the previous response.

Errors and what you pay

Status	Meaning	Charged
`200`	Success	Yes, unless cached
`400`	A parameter is missing or wrong	No
`401`	The key is missing or invalid	No
`402`	Not enough credits	No
`403`	The account or post is private	No
`404`	Not found on the platform	No
`429`	More than 300 requests a minute	No
`502`	Every source is down; retry shortly	No

Same endpoint in other languages

Python · Node.js · JavaScript · TypeScript · Go · Rust · Java · C# · PHP · Ruby · Swift · R

Prefer no code?

Connect the MCP server to Claude Code, Cursor or Codex and ask in plain English. The agent uses call_endpoint with path /v1/facebook/marketplace/search for you.

100 free credits, no card. Credits never expire.

Get API key