Extract public Facebook Marketplace listings by city feed, category, keyword search, or direct item URL, with price, location, photos, delivery method, seller, and listing status per item. Output fiel
Extract public Facebook Marketplace listings by city feed, category, keyword search, or direct item URL, with price, location, photos, delivery method, seller, and listing status per item.
nimbryxo-studio~facebook-marketplace-listing-and-price-extractor)references/example-input.jsonreferences/input-schema.jsonreferences/output-fields.jsonUse this skill when the user wants:
Do not use it for private, login-protected or paywalled data.
One JSON row per result. Columns from the Actor's dataset schema:
title: Titleprice: Pricecity: Citystate: StatelocationText: Locationcondition: ConditiondeliveryTypes: Deliveryseller: SellerprimaryPhotoUrl: PhotolistingUrl: Listing URLAll 75 declared fields: references/output-fields.json.
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| mode | string | no | auto | What to scrape. auto uses startUrls when present and otherwise builds a keyword search. search builds a search from searchQueries plus location. |
| startUrls | array | no | [] | Marketplace search, city-category, global-category, city-feed, or /marketplace/item/ URLs. In mode=items, a bare numeric listing ID is also accepted. |
| searchQueries | array | no | [] | One to 20 keywords or phrases (mode=search or mode=auto without URLs). Each query becomes one source. |
| location | string | no | | Marketplace location slug, city, postal code, or address used by keyword search (mode=search or mode=auto without URLs). Examples: nyc, Austin, Texas, 90210, London. |
| country | string | no | US | ISO 3166-1 alpha-2 country used when resolving a human location. Use GB for London, CA for Toronto, and so on. |
| latitude | number | no | | Optional search center latitude. Provide longitude too. |
| longitude | number | no | | Optional search center longitude. Provide latitude too. |
| radiusKm | integer | no | 65 | Search radius in kilometres for keyword or category search. URL mode keeps the radius in the URL unless you set this explicitly. |
| category | string | no | all | Marketplace category. If searchQueries is empty, the actor opens the city category feed (or the global category feed for a human location). |
| categoryId | string | no | | Advanced numeric Facebook category ID. Takes precedence over category when set. |
| sortBy | string | no | relevance | Server-side sort where Marketplace supports it, plus a client-side re-sort by price or posting time. Rows without a price sort last. |
| minPrice | number | no | | Only listings at or above this price. Rows without a price are dropped. |
| maxPrice | number | no | | Only listings at or below this price. Rows without a price are dropped. |
| condition | string | no | any | Server-side condition filter in search/category modes. In deep mode the detail condition is checked too; fast URL rows without condition data are kept. |
13 more optional fields on the Actor's Input tab.
Example:
{
"mode": "auto",
"startUrls": [],
"searchQueries": [],
"country": "US",
"radiusKm": 65,
"category": "all",
"sortBy": "relevance",
"condition": "any",
"deliveryMethod": "all",
"availability": "all",
"exactMatch": false,
"maxItems": 50,
"maxItemsPerUrl": 50,
"maxPagesPerUrl": 100,
"scrapeMode": "fast",
"includeListingDetails": false,
"includeAllPhotos": false,
"rehostImages": true,
"deduplicateAcrossInputs": true,
"location": "New York, NY"
}
Set APIFY_TOKEN, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
curl -s -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~facebook-marketplace-listing-and-price-extractor/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
Or with Node 18+: node scripts/run.mjs [input.json].
For large runs, start an async run and read its dataset when it finishes:
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~facebook-marketplace-listing-and-price-extractor/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
Weekly roundup of top Claude Code skills, MCP servers, and AI coding tips.