# Facebook Marketplace Scraper - Price & Location \[NO LOGIN] ✅ (`unseenuser/fb-marketplace`) Actor Search Facebook Marketplace by keyword and location, then pull every listing: title, price, photos, condition, delivery and coordinates. Monitor newest items on a schedule for flippers and resellers, or drill into any item for full details. No login, no cookies. - **URL**: https://apify.com/unseenuser/fb-marketplace.md - **Developed by:** [Unseen User](https://apify.com/unseenuser) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing $4.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🛒 Facebook Marketplace Scraper (No Login) > **Search Facebook Marketplace by keyword and location - price, photos, condition, delivery, item details and coordinates. No login. Monitor newest items.** > > **Tier:** Combined-Endpoint Bundle - Reseller / Monitoring Niche --- ### ⚡ Why This Actor? Combined-endpoint actor: input one or more keywords plus a location, get back every Facebook Marketplace listing (title, price, photos, condition, delivery options, location) and optionally drill into any item for the full description, attributes, every photo and exact coordinates. Built for resellers, price tracking and market research. Marketplace is the one Facebook category where true keyword search works - this Actor leans into it with a native newest-items monitoring mode. Seller identity is not reliably returned, so the Actor leads with listing, price, location and photos, which are reliable. You search listings - you do NOT scrape private messages or buyer/seller conversations. ### 🆓 Free plan limit Free Apify users get up to **50 results per run**. Paying users are not affected and receive results normally. This limit was set by the Actor developer, not by Apify. To remove it and receive unlimited results, upgrade to any paid Apify plan: https://apify.com/pricing When a free plan run hits the cap, the Actor finishes successfully (status `SUCCEEDED`) and the run's status message explains what happened. No error is raised, so the first 50 results are fully usable as normal. ### 🎯 Use Cases - **Reseller sourcing** - find underpriced listings by keyword and location to flip - **Newest-item monitoring** - schedule runs with newest-first plus a 24h window to catch listings the moment they post - **Price tracking** - watch how asking prices for a category move over time in a market - **Market research** - measure supply, price bands and condition mix for a product in a geography - **Vehicle and real-estate monitoring** - track cars or rentals appearing within a radius - **Inventory enrichment** - pull full item detail (attributes, all photos, coordinates) only for listings you care about ### 🚀 Quick Start 1. Click **Try for free** on this Actor's page 2. The form pre-fills `queries: ["bike"]` and `locationName: "Austin, TX"`. Edit or accept. 3. Click **Start** 4. Download results as JSON, CSV, or XLSX, or pull via Apify API ### ⚙️ Inputs Overview | Input | Type | Required | Description | Example / Allowed Values | |---|---|---|---|---| | `queries` | array of strings | ✅ | One or more search keywords. Each keyword is searched independently; results are combined in a single dataset with the source keyword stamped on every row in `query`. | `["bike", "iphone", "sofa"]` | | `locationName` | string | ❌ | City or place name; resolved to coordinates automatically. Use this OR lat/lng. | `Austin, TX` | | `lat` | string | ❌ | **⚠️ One of locationName / (lat+lng) required.** Latitude. | `30.2672` | | `lng` | string | ❌ | Longitude. | `-97.7431` | | `radiusKm` | integer | ❌ | Search radius in km. Default 65. | `65` | | `minPrice` | integer | ❌ | Minimum price filter. | `50` | | `maxPrice` | integer | ❌ | Maximum price filter. | `500` | | `condition` | enum | ❌ | Item condition. | `new`, `used_like_new`, `used_good`, `used_fair` | | `sortBy` | enum | ❌ | Sort order. Default `creation_time_descend`. | `suggested`, `distance_ascend`, `creation_time_descend`, `price_ascend`, `price_descend` | | `dateListed` | enum | ❌ | Listing recency. Default `all`. | `all`, `last_24_hours`, `last_7_days`, `last_30_days` | | `availability` | enum | ❌ | Default `available`. | `available`, `sold`, `all` | | `deliveryMethod` | enum | ❌ | Default `all`. | `all`, `local_pickup`, `shipping` | | `maxResultsPerQuery` | integer | ❌ | Hard cap per keyword. Default 100. | `100` | | `fetchItemDetails` | boolean | ❌ | Pull the full description, attributes and every photo for each listing. Leave off for cheaper, faster runs. | `false` | | `monitorMode` | boolean | ❌ | For scheduled runs: only return listings not seen in prior runs (dedup by `id`). | `false` | #### Bulk keyword runs - The Actor resolves the location once and reuses it across every keyword. - Each keyword paginates independently up to `maxResultsPerQuery`. - Listings are deduplicated by `id` across the entire run, so a listing matching `bike` and `mountain bike` appears only once. - A failure on one keyword (rate limit, 5xx, parse error) is isolated and does not affect the other keywords. - The dataset row carries the source keyword in `query`, so you can filter or partition downstream. #### Newest-item monitoring pattern ```json { "queries": ["e-bike", "mountain bike"], "locationName": "Austin, TX", "radiusKm": 50, "sortBy": "creation_time_descend", "dateListed": "last_24_hours", "monitorMode": true } ```` Run on a 10-15 minute Apify schedule. The first run captures every match from the last 24 hours; every subsequent run only emits listings whose `id` has never been seen before. The Actor persists seen IDs in the key-value store for you. ### 📤 Output Each dataset row is one listing, flat and ready to export. Example with `fetchItemDetails: false`: ```json { "id": "1880804689276480", "title": "ANCHEER E Bike", "url": "https://www.facebook.com/marketplace/item/1880804689276480/", "price": 300, "price_formatted": "$300", "city": "Austin", "state": "TX", "location_display": "Austin, Texas", "city_page_id": "106224666074625", "is_live": true, "is_sold": false, "primary_photo": "https://scontent-.../photo.jpg", "delivery_types": ["IN_PERSON", "PUBLIC_MEETUP"], "category_id": "1658310421102081", "story_type": "POST", "query": "bike", "page": 1, "fetched_at": "2026-06-03T20:34:38.149Z" } ``` With `fetchItemDetails: true`, each row additionally carries `description`, `attributes`, `photos`, `photo_count`, `latitude`, `longitude`, `creation_time`, `currency` and `item_detail_fetched`. Fields whose value is `null` are omitted from the row, so the export stays clean. #### Dataset views The Apify Console renders three pre-configured tabs over the dataset: - **Listings overview** (default) - photo thumbnail, title, price, location, sold flag, delivery, listing link, keyword, fetched time. - **Detailed view** - every column the search endpoint returns (IDs, flags, category, story type), no item-detail nulls. - **With item details** - the columns that require `fetchItemDetails=true` (description, attributes, exact coordinates, full photo set). #### Live view While a run is in progress, the Actor exposes a small live-view HTTP server documented by an OpenAPI v3 schema (`/`, `/health`, `/status`). Use it to monitor a long run without polling the dataset. ### 💰 Pricing Pay-per-event model on Apify. See exact per-event pricing on this Actor's Apify page. > **⚠️ Cost Warning:** `fetchItemDetails=true` triggers one extra request per listing for description, attributes and the full photo set. Leave it off unless you actually need that data. ### 🔌 Integrations - **Schedules** - use Apify's Schedules feature for newest-item monitoring. Pair with `monitorMode=true` so each run only emits listings it has not seen before. - **Webhooks** - configure an Apify webhook on `ACTOR.RUN.SUCCEEDED` to push new listings into Slack, Discord, Zapier, n8n, Make, or any HTTP endpoint as soon as a run finishes. - **Apify API** - pull results programmatically via the standard `Get dataset items` endpoint. - **CSV / Google Sheets** - the dataset exports cleanly into spreadsheets; pair with Apify's Google Sheets integration to append rows automatically. ### 🧑‍💻 API examples Start a run with the Apify API (replace `YOUR_TOKEN` and `YOUR_USER` with your values): ```bash curl -X POST \ "https://api.apify.com/v2/acts/YOUR_USER~facebook-marketplace-scraper/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "queries": ["e-bike", "mountain bike"], "locationName": "Austin, TX", "radiusKm": 50, "sortBy": "creation_time_descend", "dateListed": "last_24_hours", "monitorMode": true }' ``` Fetch the latest dataset items synchronously: ```bash curl "https://api.apify.com/v2/acts/YOUR_USER~facebook-marketplace-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "queries": ["sofa"], "lat": "30.2672", "lng": "-97.7431", "maxResultsPerQuery": 50 }' ``` Node.js with the Apify client: ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const { defaultDatasetId } = await client .actor('YOUR_USER/facebook-marketplace-scraper') .call({ queries: ['iphone 14', 'iphone 15'], locationName: 'Austin, TX', condition: 'used_good', sortBy: 'price_ascend', maxResultsPerQuery: 100, }); const { items } = await client.dataset(defaultDatasetId).listItems(); console.log(`Got ${items.length} listings`); ``` ### ❓ FAQ **Q: Is this legal?** A: This Actor wraps third-party endpoints that handle the underlying data collection. Your downstream use of the data is your responsibility - see the full Terms of Service and the Actor-Specific Addendum below. **Q: Do I need a Facebook account?** A: No. The Actor does not log into Facebook. **Q: What about Facebook's anti-scraping enforcement?** A: Meta's Terms restrict automated extraction. The third-party API provider handles the data collection; they bear the responsibility for their architecture's lawfulness. Your downstream use must comply with Meta's Terms. **Q: What if Meta sends a cease-and-desist?** A: Notify UnseenUser within 48 hours via the Apify profile contact form (https://apify.com/UnseenUser) and cease using this Actor immediately. **Q: Can I use this data to train AI?** A: NO. Meta's Terms prohibit AI training on Facebook data, and listing photos and descriptions are copyrighted by their creators. **Q: What about minors?** A: Facebook has many under-18 users, and some Marketplace sellers may be minors. This Actor's Terms strictly prohibit using data of users you know or suspect are minors. See the Addendum below for details. **Q: Can I search by city name, or do I need coordinates?** A: Both. Pass `locationName` (e.g. `Austin, TX`) and it is resolved to lat/lng automatically, or pass raw `lat`/`lng` yourself. Search itself requires coordinates under the hood. **Q: How does "monitor newest" work?** A: Set `sortBy=creation_time_descend`, `dateListed=last_24_hours` and `monitorMode=true`, then run on a schedule. The Actor dedups by listing `id` so each run only returns listings it has not seen before. **Q: Do I get the seller's identity?** A: Often no. The `seller` field is frequently `null`, so do not rely on it. The reliable fields are listing, price, location, photos and item attributes. **Q: When should I enable full item details?** A: Only when you need the description, structured attributes and every photo for a listing. It triggers one extra call per listing. ### 🔧 Technical Details - Output: streamed via Apify dataset. - Format: JSON, CSV, XLSX, RSS, HTML, or via the Apify API. - Retries: 3 with exponential backoff (1s, 2s, 4s) on transient errors. - Request timeout: 60s per upstream call. - Pagination: cursor-based; runs stop at `maxResultsPerQuery` or when there is no next page. - Concurrency: 1 within search pagination per keyword; keywords run sequentially. - Dedup: by listing `id` within a run and (with `monitorMode=true`) across scheduled runs. - Error isolation: a failure on one keyword does not affect the others; the failure is recorded in the run summary. *** ## Apify Actor - Terms of Service **Version:** 4.0 **Effective Date:** May 5, 2026 *** ### 0. ACCEPTANCE BY USE - IMPORTANT **Read this section first.** These Terms of Service ("Terms") form a binding legal agreement between you ("User," "you," "your") and UnseenUser, the Publisher of this Apify actor ("UnseenUser," "the Publisher," "we," "us," "our"). #### 0.1 How You Accept These Terms You accept these Terms by **any of the following actions**, each of which constitutes a clear, affirmative act of acceptance: - (a) **Running the Actor** - Initiating any execution of the Actor on the Apify platform - (b) **Using any output** returned by the Actor for any purpose - (c) **Continuing to access** the Actor's listing or documentation after these Terms are visible #### 0.2 Continuing Acceptance Each time you run the Actor or use its outputs, you reaffirm your acceptance of the then-current Terms. If you do not agree to these Terms or any subsequent update, you must stop using the Actor immediately. #### 0.3 No Anonymous Acceptance You cannot disclaim acceptance by: - Failing to read these Terms before running the Actor - Running the Actor through automated systems - Sharing your Apify account with others who may not have read these Terms By the act of running the Actor on Apify, you bind yourself, your organization (if applicable), and any individuals or systems acting on your behalf or under your authority. #### 0.4 If You Do Not Accept **If you do not agree to these Terms, you must not run the Actor.** No use is authorized without acceptance. *** ### PREAMBLE - UNDERSTANDING THE ARCHITECTURE Before using the Actor, please understand the technical architecture of the service: #### The Data Flow You (User) -> Apify Platform -> Actor (software) -> Third-Party API -> Source Platform You (User) <- Apify Platform <- Actor (software) <- Third-Party API #### What Each Party Does - **You (the User):** Run the Actor on the Apify platform with input parameters you choose - **Apify:** Operates the cloud infrastructure that hosts and executes Actors. Apify is a Czech-incorporated company (Apify Technologies s.r.o.) governed by its own Terms of Service. - **The Publisher (us):** Publishes software code (the Actor) on Apify's platform. The Actor is a thin wrapper that translates your input into requests to a third-party API and returns the API's responses to you. **The Publisher does not operate scraping infrastructure. The Publisher does not store or retain data returned by the Actor. The Publisher does not see, log, or process the personal data of any individuals returned in the Actor's outputs beyond what is incidental to passing the data through.** - **Third-Party API Provider:** HarvestAPI (https://harvest-api.com) or Scrape Creators (https://scrapecreators.com). These are independent third-party companies that operate scraping infrastructure and return data from source platforms. - **Source Platform:** LinkedIn, TikTok, YouTube, Reddit, Linktree, etc. These are the platforms whose publicly visible data is accessed by the Third-Party API Providers. #### Why This Matters Your relationship with the Publisher is that of a **software user** to a **software vendor**. The Publisher has the responsibilities of a software vendor (functional code, accurate documentation) and the limits of one (the Publisher is not responsible for how you use the data you obtain). *** These Terms operate alongside but do not replace: - Apify's Terms of Service and Acceptable Use Policy (governing your relationship with Apify) - HarvestAPI Terms of Service and Scrape Creators Terms of Service (governing the underlying data infrastructure) - Source Platform terms (LinkedIn, TikTok, etc.) governing the public data accessed - Applicable law in your jurisdiction and the jurisdictions of data subjects These Terms incorporate the actor-specific addendum published in each Actor's individual listing ("Addendum"). In the event of a conflict, the more restrictive provision applies. *** ### 1. NATURE OF THE SERVICE #### 1.1 What the Actor Is The Actor is a software program published on the Apify platform. Each Actor: - (a) Accepts structured input from you on the Apify platform - (b) Translates that input into HTTP requests to a third-party API operated by HarvestAPI or Scrape Creators - (c) Receives HTTP responses from that third-party API - (d) Returns the response data to you in a structured format on the Apify platform The Actor's source code is hosted on Apify's infrastructure. The Actor runs in Apify's cloud, not on the Publisher's servers. The Publisher operates no servers running the Actor. #### 1.2 What the Actor Is Not The Actor is **not**: - (a) A scraping tool - the Publisher does not operate scraping infrastructure, proxies, headless browsers, or fake accounts - (b) A direct connection to any source platform - connections to source platforms are made by HarvestAPI / Scrape Creators - (c) A data storage or data retention service - the Publisher does not maintain a database of any data the Actor returns - (d) A licensed access channel to LinkedIn, TikTok, YouTube, Reddit, X (Twitter), Meta, Linktree, or any other source platform - (e) Affiliated with, endorsed by, sponsored by, or authorized by any source platform #### 1.3 The Publisher's Limited Role The Publisher's role is limited to: - (a) Designing and writing the Actor's source code - (b) Publishing the Actor on the Apify Store - (c) Maintaining the Actor (updating it when API providers change schemas) - (d) Providing documentation and customer support via Apify's contact mechanism The Publisher is a software vendor, similar to a developer who publishes an app on the Apple App Store or Google Play Store. The Publisher is not a data provider, data broker, data processor, or data controller for purposes of GDPR, CCPA, Israel's Privacy Protection Law, or equivalent. #### 1.4 The Third-Party API Providers' Role HarvestAPI (https://harvest-api.com) and Scrape Creators (https://scrapecreators.com) are independent third-party companies. They: - (a) Operate the actual data scraping infrastructure - (b) Maintain relationships with source platforms (or accept the operational risk of accessing public data without such relationships) - (c) Are themselves Apify publishers (HarvestAPI publishes 9+ actors directly; Scrape Creators publishes 10+) - (d) Provide their own Terms of Service governing their operations - (e) Are responsible for compliance obligations relating to the data collection itself The Publisher is a customer of these providers. The Publisher is not their agent, partner, or representative. *** ### 2. WHO MAY USE THE ACTOR #### 2.1 Eligibility You may use the Actor only if: - (a) You are at least 18 years old or the age of majority in your jurisdiction - (b) You have legal capacity to enter into binding contracts - (c) You are not located in or resident of a country subject to comprehensive sanctions by the United States, European Union, United Kingdom, or Israel - (d) You are not on any prohibited persons list #### 2.2 User Representations By using any Actor, you represent and warrant that: - (a) **Truthful identity:** Information you provide about your identity and intended use is accurate - (b) **Lawful intent:** Your intended use complies with applicable law in your jurisdiction - (c) **Source platform compliance:** You will independently comply with the Terms of Service of any source platform whose data you obtain through the Actor - (d) **Data subject rights:** Where Actor outputs include personal data, you will respect data subject rights under applicable law - (e) **No prohibited use:** You will not use the Actor for any of the purposes prohibited in Section 4 These representations are continuous - they must remain true throughout your use. *** ### 3. PERMITTED USES The Actor may be used for any lawful purpose, including: - Market research and competitive analysis - Academic research - Journalism and investigative reporting - Internal business intelligence - Brand monitoring - Recruitment research where consistent with applicable employment law - Building products that further process publicly available information lawfully Specific permitted uses for each Actor are described in that Actor's individual listing and Addendum. *** ### 4. PROHIBITED USES You may not use the Actor for any of the following: #### 4.1 Illegal Activity Activity illegal under the law of your jurisdiction, the User's jurisdiction, or the jurisdiction of any data subjects. #### 4.2 Harassment, Stalking, and Personal Targeting - Compiling profiles for harassment, stalking, or doxxing - Tracking individuals' movements or activities without their knowledge - Building profiles of journalists, activists, dissidents, or vulnerable populations for retaliatory purposes #### 4.3 Discrimination - Using outputs for discriminatory employment, lending, housing, or insurance decisions based on protected characteristics - Building lists for discriminatory purposes #### 4.4 Spam and Unsolicited Commercial Communication - Sending unsolicited marketing in violation of CAN-SPAM, CASL, GDPR, PECR, Israeli Anti-Spam Law (Section 30A of the Communications Law), or equivalent laws - Building "lead lists" from scraped contacts without proper consent infrastructure - Reselling contact data for spam purposes #### 4.5 Fraud and Deception - Identity theft or impersonation - Generation of fake reviews, testimonials, or coordinated inauthentic behavior - Election interference or political disinformation - Securities fraud #### 4.6 Source Platform Abuse - Using outputs to circumvent technical protection measures of source platforms - Creating fake accounts on source platforms based on Actor outputs - Vote manipulation, engagement manipulation, or platform algorithm gaming - Building services that competitively substitute for source platforms #### 4.7 Reselling the Actor's Service - Reselling raw Actor outputs as your own data product or scraping-as-a-service - Sharing your Apify credentials to provide third parties indirect access - Building competing API services using Actor outputs #### 4.8 AI Training Without Authorization - Using Actor outputs as training data for commercial AI/ML models without separate licensing authority from the source platform #### 4.9 Sensitive Targeting - Specifically targeting or profiling based on health conditions, sexual orientation, religious beliefs, political opinions, or other sensitive characteristics - Targeting children under 16 (or local age of consent for data processing) #### 4.10 Privacy Law Violations - Processing personal data of EU/UK/California/Israeli residents without complying with applicable privacy law - Failing to honor data subject access, deletion, or objection requests - Processing data for purposes incompatible with its publication context *** ### 5. SOURCE PLATFORM TERMS - YOUR RESPONSIBILITY #### 5.1 Acknowledgment The Actor accesses publicly visible data on third-party platforms ("Source Platforms") through the Third-Party API Providers (HarvestAPI / Scrape Creators). Source Platforms include LinkedIn, TikTok, YouTube, Reddit, X (Twitter), Meta/Facebook, Linktree, Komi, Pillar, Linkbio, Linkme, and Amazon. #### 5.2 Your Sole Responsibility You acknowledge: - (a) **You are solely responsible for ensuring your downstream use of data obtained through the Actor complies with the Source Platform's Terms of Service** - (b) The Publisher makes no representation that any specific use is permitted under any Source Platform's terms - (c) The Third-Party API Providers, not the Publisher, bear responsibility for the lawfulness of the data collection itself - (d) You should review Source Platform terms before commercial use: - LinkedIn: https://www.linkedin.com/legal/user-agreement - TikTok: https://www.tiktok.com/legal/page/global/terms-of-service/en - YouTube: https://www.youtube.com/static?template=terms - X: https://twitter.com/en/tos - Reddit: https://www.redditinc.com/policies/user-agreement - Meta: https://www.facebook.com/legal/terms - Linktree: https://linktr.ee/s/terms/ #### 5.3 Cease-and-Desist Compliance If you receive a cease-and-desist letter or other legal demand from a Source Platform regarding your use of Actor outputs, you must: - (a) Cease the contested use immediately - (b) Notify UnseenUser within 48 hours via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) - (c) Cooperate with the Publisher as needed to mitigate - (d) Not assert against the Publisher any claim arising from your inability to use the Actor for that Source Platform *** ### 6. DATA PROTECTION - REFLECTING ACTUAL ARCHITECTURE #### 6.1 Roles Under Privacy Law For purposes of GDPR, UK GDPR, CCPA, Israel's Privacy Protection Law (PPL) including Amendment 13, and equivalents: - **You (the User) are the Data Controller** of any personal data you obtain through the Actor and subsequently process for your own purposes - **HarvestAPI and Scrape Creators** are the entities that collect data from source platforms - they bear the responsibilities of data processors or controllers (depending on context) for the collection itself - **The Publisher acts solely as a software vendor**, not as a data controller or processor, because the Publisher does not store, retain, or substantively process personal data - the Actor merely passes API responses through #### 6.2 No Data Retention by the Publisher The Publisher confirms: - (a) The Publisher does not maintain a database of personal data obtained through the Actor - (b) The Actor passes data from the Third-Party API directly to you on the Apify platform - data does not flow through the Publisher's infrastructure - (c) Apify's standard execution and operational logging may include limited information about Actor runs (input parameters, run duration, data volume) - this is governed by Apify's own privacy practices - (d) The Publisher does not access, view, or analyze your Actor outputs except as needed for technical support if you specifically share them with the Publisher #### 6.3 Your Obligations as Data Controller Where your use of the Actor involves processing personal data, you are responsible for: - (a) Establishing a lawful basis for your processing (consent, legitimate interest with documented balancing test, contract, etc.) - (b) Providing transparent notice to data subjects as required by applicable law - (c) Honoring data subject access, rectification, erasure, restriction, and portability requests - (d) Implementing appropriate security measures - (e) Conducting Data Protection Impact Assessments where required - (f) Appointing a Data Protection Officer if your operations require one - (g) Registering databases with applicable supervisory authorities - (h) Honoring opt-out requests for direct marketing - (i) Cross-border transfer safeguards where data crosses borders #### 6.4 Israel's Amendment 13 - User Compliance If your use of the Actor involves Israeli residents' personal data, you must comply with the Privacy Protection Law as amended (Amendment 13, effective August 14, 2025). These obligations are yours as the data controller, not the Publisher's as the software vendor. #### 6.5 Sensitive Data Targeting Restrictions You will not use the Actor to specifically target, profile, or build datasets focused on: - Health or medical conditions - Religious beliefs - Political opinions - Sexual orientation or gender identity - Genetic or biometric data - Criminal history - Children under 16 *** ### 7. INTELLECTUAL PROPERTY #### 7.1 Actor Code The Actor's source code, schemas, documentation, and branding are owned by the Publisher. You receive a limited, non-exclusive, non-transferable, revocable license to use the Actor for permitted purposes during your active subscription/run with Apify. #### 7.2 Output Data The Publisher claims no ownership over the public data the Actor returns. Source Platforms may have copyright, database rights, or other rights in their data; data subjects may have copyright in user-generated content. Your use of output data must respect these rights independently. #### 7.3 Restrictions You may not reverse engineer, decompile, or reuse the Actor's code in a competing actor. #### 7.4 Feedback Feedback you provide may be used by the Publisher to improve products without compensation to you. *** ### 8. PRICING AND PAYMENT #### 8.1 Apify Platform Billing Pricing is administered through Apify's pricing models. Apify processes all payments. Apify's payment terms govern refunds and disputes. #### 8.2 Pricing Changes The Publisher may change Actor pricing with at least 14 days' notice via the Actor's Apify listing. #### 8.3 No Refunds for Misuse If your access is suspended or terminated for breach of these Terms, you forfeit any unused balance and are not entitled to refunds. *** ### 9. SERVICE AVAILABILITY AND CHANGES #### 9.1 No Uptime Guarantee The Actor depends on: - (a) The Apify platform - (b) Underlying API providers (HarvestAPI, Scrape Creators) - (c) Source Platforms' continued public accessibility Any of these may change behavior, restrict access, or become unavailable without notice. The Publisher makes no uptime guarantees. #### 9.2 Service Discontinuation The Publisher may discontinue any Actor at any time. Reasonable notice will be provided when feasible. *** ### 10. DISCLAIMERS #### 10.1 "AS IS" Service THE ACTOR IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR PURPOSE, NON-INFRINGEMENT, OR ACCURACY OF DATA. #### 10.2 No Representation of Lawfulness The Publisher makes no representation that your specific use of the Actor or the data it returns is lawful in your jurisdiction or under any Source Platform's terms. The burden of determining lawfulness for your use case is yours. #### 10.3 No Endorsement of Source Content Content returned by the Actor was created by third parties. The Publisher does not endorse, verify, or take responsibility for it. *** ### 11. LIMITATION OF LIABILITY #### 11.1 Aggregate Liability Cap TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE AGGREGATE LIABILITY OF THE PUBLISHER FOR ALL CLAIMS RELATING TO THE ACTOR EXCEED THE GREATER OF: - (a) ONE HUNDRED U.S. DOLLARS (US $100), OR - (b) THE AMOUNTS YOU PAID THROUGH APIFY FOR USE OF THE ACTOR IN THE THREE (3) MONTHS IMMEDIATELY PRECEDING THE EVENT #### 11.2 Excluded Damages THE PUBLISHER IS NOT LIABLE FOR INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR LOSS OF PROFITS, REVENUE, OR DATA, EVEN IF ADVISED OF THE POSSIBILITY. #### 11.3 Time Limit Any claim must be brought within one (1) year of the event. *** ### 12. INDEMNIFICATION #### 12.1 Your Indemnification of the Publisher You agree to defend, indemnify, and hold harmless the Publisher from any: - Claims arising from your use of the Actor - Claims arising from your violation of these Terms - Claims arising from your violation of any law (including privacy law) - Claims arising from your violation of any Source Platform's Terms of Service - Claims arising from your processing of personal data obtained through the Actor - Reasonable attorneys' fees and costs of defending such claims #### 12.2 Defense The Publisher may assume defense at your expense. You will cooperate with the Publisher's defense. #### 12.3 Scope The indemnification covers reasonable, foreseeable third-party claims arising from your use. It does not extend to: - Claims arising from the Publisher's gross negligence or willful misconduct - Claims regarding the Actor's source code itself (those are the Publisher's responsibility) - Claims regarding the Third-Party API Provider's data collection (those are their responsibility) *** ### 13. SUSPENSION AND TERMINATION #### 13.1 Termination by the Publisher The Publisher may terminate your access for material breach, illegal use, breach of warranty, or upon credible legal demand. #### 13.2 Effects of Termination Your license ends, you must cease use, and applicable provisions survive. #### 13.3 Termination by You You may stop using the Actor at any time on Apify. *** ### 14. DISPUTE RESOLUTION #### 14.1 Informal Resolution First Send a detailed written description of the dispute via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) and wait 60 days for resolution attempt before any formal claim. #### 14.2 Governing Law These Terms are governed by the substantive laws of the State of Israel, without regard to conflict of law principles. #### 14.3 Exclusive Jurisdiction Any dispute shall be brought exclusively in the competent civil courts of Tel Aviv-Jaffa, Israel. #### 14.4 No Class Actions You agree to bring claims only in your individual capacity. #### 14.5 Attorneys' Fees The prevailing party recovers reasonable attorneys' fees. *** ### 15. MISCELLANEOUS #### 15.1 Entire Agreement These Terms (with Addendum and incorporated documents) are the entire agreement. #### 15.2 Severability Unenforceable provisions are reformed to the minimum extent or severed. #### 15.3 Assignment You may not assign without the Publisher's consent. The Publisher may assign to affiliates, successors, or acquirers. #### 15.4 Force Majeure Neither party is liable for failure due to events beyond reasonable control, including changes by Source Platforms or Third-Party API Providers, or actions by Apify. #### 15.5 Third-Party Beneficiaries Apify, HarvestAPI, and Scrape Creators are intended third-party beneficiaries of Sections 4 (Prohibited Uses), 5 (Source Platform Compliance), and 12 (Indemnification). #### 15.6 Survival Sections 0 (Acceptance), 4, 5, 6, 7, 10, 11, 12, 14, and 15 survive termination. #### 15.7 Language English controls. Translations are for convenience only. #### 15.8 Publisher Identification for Legal Process The Publisher operates on the Apify platform under the username **UnseenUser** (https://apify.com/UnseenUser). The Publisher is a registered legal entity. Upon receipt of valid legal process (subpoena, court order, or equivalent) directed through Apify's official channels, the Publisher's full legal identity may be disclosed as required by law. This Section ensures that you have a valid path to legal recourse if needed. *** ### 16. ACKNOWLEDGMENT By using any Actor, you acknowledge that: - (a) You have read these Terms - (b) You understand the architecture: you are using software (the Actor) on Apify's platform that calls third-party APIs - (c) You accept responsibility for your use, including for compliance with Source Platform terms - (d) Your indemnification obligations cover third-party claims arising from your use - (e) Disputes are resolved in Israeli courts - (f) The Publisher's identity, while not publicly disclosed in this listing, can be obtained through valid legal process via Apify For questions, use UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) before running the Actor. *** ### APPENDIX - Document Version History | Version | Date | Summary | |---------|------|---------| | 1.0 | May 5, 2026 | Initial publication | | 2.0 | May 5, 2026 | Hardened (over-broad - treated User as data broker) | | 3.0 | May 5, 2026 | Architecturally accurate - Publisher as software vendor | | 4.0 | May 5, 2026 | **Anonymous Publisher.** All personally identifying information removed. Acceptance-by-Use mechanism formalized. | *** *These Terms reflect best practices for anonymous Apify actor publishing as of May 2026. Not a substitute for legal advice. Consult qualified Israeli commercial counsel before deploying.* *** ## 🛡️ Actor-Specific Terms of Service Addendum ### 🛡️ Actor-Specific ToS Addendum - 🛒 Facebook Marketplace Scraper This addendum supplements the Master Terms of Service V4.0 above. By running this Actor, you accept both the Master ToS and this addendum. #### A. Architectural Disclosure This Actor is a software wrapper. It accepts your input parameters, calls up to THREE Scrape Creators endpoints in sequence (`/v1/facebook/marketplace/location/search` to resolve a place name, `/v1/facebook/marketplace/search` to find listings, and optionally `/v1/facebook/marketplace/item` to enrich each listing), combines the results into a structured output, and returns the combined data to you on the Apify platform. UnseenUser does not store, log, or substantively process the data returned. The data flows from Scrape Creators through Apify's runtime directly to you. #### B. Nature of Data Returned This Actor returns Facebook Marketplace listing data: listing title, price (formatted amount, numeric amount, currency, any strikethrough price), primary and full photo sets, condition and structured attributes, delivery types, listing status (live/sold/pending/hidden), listing and city location with display name and city\_page\_id, and - when item detail is enabled - the full description, exact coordinates (latitude/longitude), creation time, and share URI. A `seller` field exists in the item schema but is frequently `null` and must not be treated as reliable seller identity. Where the Actor's output includes individual people's names, photos, contact details, or content authored by them, that data constitutes **personal data** subject to GDPR, CCPA, Israeli Privacy Protection Law (including Amendment 13), and equivalent privacy laws in your downstream processing - but **only in your hands as the data controller**, not in UnseenUser's hands as the software vendor. Marketplace listings posted by private individuals (not businesses) are especially likely to contain personal data, and listing coordinates can reveal where a person lives. #### C. Permitted Use Cases You may use this Actor for the following purposes (non-exhaustive list): - **Reseller sourcing** - find underpriced listings by keyword and location to flip - **Newest-item monitoring** - schedule runs to catch listings the moment they post - **Price tracking** - watch how asking prices for a category move over time in a market - **Market research** - measure supply, price bands and condition mix for a product in a geography - **Vehicle and real-estate monitoring** - track cars or rentals appearing within a radius - **Inventory enrichment** - pull full item detail only for listings you care about #### D. Specifically Prohibited Uses In addition to Master ToS Section 4 prohibitions, you may NOT: - Scrape or infer a seller's personal contact details and use them for unsolicited contact outside Facebook's own messaging - Sell or redistribute compiled listing or seller lists as a standalone data product (data broker activity) - Use listing coordinates or location data to physically target, follow, or surveil a specific seller - Aggregate one seller's listings over time to build a behavioral profile of that individual without a lawful basis - Use the Actor to facilitate scams, fake-listing schemes, or circumvention of Marketplace fraud and safety controls - Republish listing photos or descriptions in commercial products without licensing from the creator - Train commercial AI/ML models on listing content (photos, descriptions) without separate licensing authority #### E. Platform Terms of Service Considerations Meta's Terms of Service prohibit automated extraction. Meta has aggressively litigated against scrapers (Meta v. BrandTotal - settled with permanent injunction; Meta v. Octopus Data; Meta v. Bright Data - pending). Facebook's Terms of Service prohibit automated extraction. This Actor accesses publicly visible Marketplace data via Scrape Creators - Scrape Creators bears responsibility for the lawfulness of the data collection. Your downstream use must independently comply with Meta's Terms of Service. If Meta issues a cease-and-desist regarding data obtained via this Actor, notify UnseenUser within 48 hours via the Apify profile contact form (https://apify.com/UnseenUser) and cease your use immediately. #### F. Combined-Endpoint Data Sensitivity This Actor combines up to three endpoints in one run. The combination yields data that is more sensitive than any endpoint alone: - Search alone: listing-level data (low sensitivity - mostly commercial) - Item detail alone: richer per-listing data including exact coordinates (medium sensitivity) - **Combined and run on a schedule with monitor mode**: enables building a time-series map of who is selling what, where, and when - which, for private-individual sellers, drifts toward a surveillance dataset This combined, longitudinal view is the kind of dataset that Meta specifically targets in its lawsuits. Use the combined output thoughtfully: - Don't sell the combined dataset as a product - Don't build a "Facebook Marketplace replacement" with this data - Use it for your own internal sourcing, pricing and research #### G. Geolocation Data - Special Care Item detail returns exact `latitude`/`longitude`, and search returns city-level location. Fine-grained location data is high-risk: - It can enable physical-world targeting (showing up at a private seller's address) - EU EDPB guidance treats fine-grained location data as high-risk under GDPR DPIA requirements - Israel's Amendment 13 specifically restricts location-data processing You MAY use location data for legitimate market and territory analysis (e.g. "supply of e-bikes within 50km of Austin"). You may NOT use it to identify, locate, or target a specific individual seller. #### H. Monitoring Mode - Surveillance Boundary The `monitorMode` + newest-first + 24h pattern is built for category monitoring, not person monitoring. The line is drawn around whether you are tracking a market or a person: | Use | Status | |---|---| | "Alert me to every new e-bike under $400 within 50km of Austin" | ✅ Permitted | | "Monitor a vehicle category for flips, dedup by listing id" | ✅ Permitted | | "Track every listing posted by one named seller over 6 months" | ❌ Surveillance of an individual - prohibited | | "Build a profile of a specific person's selling habits and locations" | ❌ Data broker / surveillance - prohibited | #### I. Seller Identity - Do Not Treat as Verified The `seller` field is frequently `null` and is never a substitute for identity verification. You must not: - Represent any seller-adjacent data the Actor returns as a verified identity - Use the Actor to "confirm" who a seller is for legal, financial, or safety decisions - Present scraped seller information as authoritative to downstream consumers Surface only what the API returns, and label it as unverified. #### J. Listing Content Copyright and AI Training Listing photos and descriptions are copyrighted by the people who created them. You may analyze them and quote short excerpts with attribution (typically fair use), and you may use aggregated metrics (price bands, counts - facts, no copyright issue). You may NOT republish full photos or descriptions as your own, and you may NOT use this content to train commercial AI/ML models without proper licensing. Recent litigation (NYT v. OpenAI, Andersen v. Stability AI) shows AI training on platform content is contested. Your AI training use is your own legal exposure. #### K. Minor Protection - CRITICAL Facebook has a significant under-18 user population, and some Marketplace sellers may be minors. You MUST: - NOT use this Actor to scrape or target listings of users you know or suspect are minors - NOT use this Actor for any product or service targeted at minors without parental-consent mechanisms compliant with COPPA (US), GDPR Article 8 (EU - typically parental consent below 16, sometimes 13), and Israeli Privacy Law (heightened sensitivity for minors) - DELETE any data you discover relates to a minor unless you have valid parental consent If listing metadata suggests the seller is under 18, treat the data as belonging to a minor by default and act accordingly. This restriction is non-negotiable - minor-data violations carry the highest regulatory penalties. #### L. Data Subject Rights and Cease-and-Desist Protocol Individuals whose personal data you collect have rights under GDPR / CCPA / Israeli Privacy Law: access, deletion, objection (absolute for direct marketing under GDPR Article 21), rectification, and portability. Build operational processes from day one to honor these with a typical 30-day SLA (a dedicated request email, a response log, a linked privacy policy). If a data subject contacts YOU directly demanding deletion: - Honor the request promptly (typically within 30 days under GDPR) - Do NOT route them to UnseenUser - UnseenUser is the software vendor, not the data controller - You may suggest they contact Meta directly (since the data originates there) - Document the request and your response If Meta, Scrape Creators, or a regulator contacts UnseenUser regarding your use, UnseenUser will notify Apify per Master ToS Section 8, may suspend access pending investigation, and you agree to provide documentation of your lawful basis on reasonable request. *** ### 📞 Support and Contact - **Bug reports and feature requests**: contact UnseenUser through the Apify profile contact form (https://apify.com/UnseenUser). - **General Apify questions**: see https://docs.apify.com. ### Changelog - **v1.0** - Initial release. Bulk keyword search, location helper with fallback param names, item-detail enrichment, monitor mode, three dataset views, OpenAPI-documented live view, free-plan cap with clean status message. # Actor input Schema ## `queries` (type: `array`): One or more Marketplace search keywords. Each keyword is searched independently and results are combined in a single dataset (with the source keyword in each row's \_metadata.query field). ## `locationName` (type: `string`): City or place name; resolved to coordinates automatically. Use this OR lat/lng. ## `lat` (type: `string`): Latitude. Required if locationName is not set. ## `lng` (type: `string`): Longitude. Required if locationName is not set. ## `radiusKm` (type: `integer`): Search radius in km. ## `minPrice` (type: `integer`): Minimum price filter. ## `maxPrice` (type: `integer`): Maximum price filter. ## `condition` (type: `string`): Item condition filter. ## `sortBy` (type: `string`): Result sort order. ## `dateListed` (type: `string`): How recently the listing was posted. ## `availability` (type: `string`): Listing availability. ## `deliveryMethod` (type: `string`): Delivery method filter. ## `maxResultsPerQuery` (type: `integer`): Hard cap on listings returned per keyword. The total across all keywords is bounded by this value times the number of keywords (and by the free-plan cap on free accounts). ## `fetchItemDetails` (type: `boolean`): Pull the full description, attributes and every photo for each listing. Leave off for cheaper, faster runs. ## `monitorMode` (type: `boolean`): For scheduled runs: only return listings not seen in prior runs (dedup by id). ## Actor input object example ```json { "queries": [ "bike" ], "locationName": "Austin, TX", "lat": "30.2672", "lng": "-97.7431", "radiusKm": 65, "sortBy": "creation_time_descend", "dateListed": "all", "availability": "available", "deliveryMethod": "all", "maxResultsPerQuery": 100, "fetchItemDetails": false, "monitorMode": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "bike" ], "locationName": "Austin, TX" }; // Run the Actor and wait for it to finish const run = await client.actor("unseenuser/fb-marketplace").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["bike"], "locationName": "Austin, TX", } # Run the Actor and wait for it to finish run = client.actor("unseenuser/fb-marketplace").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "bike" ], "locationName": "Austin, TX" }' | apify call unseenuser/fb-marketplace --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unseenuser/fb-marketplace", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Marketplace Scraper - Price & Location [NO LOGIN] ✅", "description": "Search Facebook Marketplace by keyword and location, then pull every listing: title, price, photos, condition, delivery and coordinates. Monitor newest items on a schedule for flippers and resellers, or drill into any item for full details. No login, no cookies.", "version": "0.0", "x-build-id": "gzib576BJIJDIDuZF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unseenuser~fb-marketplace/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unseenuser-fb-marketplace", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/unseenuser~fb-marketplace/runs": { "post": { "operationId": "runs-sync-unseenuser-fb-marketplace", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/unseenuser~fb-marketplace/run-sync": { "post": { "operationId": "run-sync-unseenuser-fb-marketplace", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Search keywords", "minItems": 1, "uniqueItems": true, "type": "array", "description": "One or more Marketplace search keywords. Each keyword is searched independently and results are combined in a single dataset (with the source keyword in each row's _metadata.query field).", "items": { "type": "string" } }, "locationName": { "title": "Location name", "type": "string", "description": "City or place name; resolved to coordinates automatically. Use this OR lat/lng." }, "lat": { "title": "Latitude", "type": "string", "description": "Latitude. Required if locationName is not set." }, "lng": { "title": "Longitude", "type": "string", "description": "Longitude. Required if locationName is not set." }, "radiusKm": { "title": "Search radius (km)", "minimum": 1, "type": "integer", "description": "Search radius in km.", "default": 65 }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Minimum price filter." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Maximum price filter." }, "condition": { "title": "Condition", "enum": [ "new", "used_like_new", "used_good", "used_fair" ], "type": "string", "description": "Item condition filter." }, "sortBy": { "title": "Sort order", "enum": [ "suggested", "distance_ascend", "creation_time_descend", "price_ascend", "price_descend" ], "type": "string", "description": "Result sort order.", "default": "creation_time_descend" }, "dateListed": { "title": "Date listed", "enum": [ "all", "last_24_hours", "last_7_days", "last_30_days" ], "type": "string", "description": "How recently the listing was posted.", "default": "all" }, "availability": { "title": "Availability", "enum": [ "available", "sold", "all" ], "type": "string", "description": "Listing availability.", "default": "available" }, "deliveryMethod": { "title": "Delivery method", "enum": [ "all", "local_pickup", "shipping" ], "type": "string", "description": "Delivery method filter.", "default": "all" }, "maxResultsPerQuery": { "title": "Max results per keyword", "minimum": 1, "type": "integer", "description": "Hard cap on listings returned per keyword. The total across all keywords is bounded by this value times the number of keywords (and by the free-plan cap on free accounts).", "default": 100 }, "fetchItemDetails": { "title": "Fetch full item details", "type": "boolean", "description": "Pull the full description, attributes and every photo for each listing. Leave off for cheaper, faster runs.", "default": false }, "monitorMode": { "title": "Monitor mode (dedup across runs)", "type": "boolean", "description": "For scheduled runs: only return listings not seen in prior runs (dedup by id).", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```