# Trade Me NZ Scraper – Marketplace, Property, Motors & Jobs (`abotapi/trademe-co-nz-scraper`) Actor Scrape trademe.co.nz across all five sections: Marketplace goods and auctions, Property, Motors, Jobs and Services. Search or paste URLs, walk pagination, and enrich with full detail plus seller feedback (positive/negative counts and score). - **URL**: https://apify.com/abotapi/trademe-co-nz-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Real estate, Jobs - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 listing results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Trade Me Scraper (trademe.co.nz) Collect listings from every part of Trade Me, New Zealand's largest online marketplace, in one actor. Search or paste links across five sections, Marketplace (general goods and auctions), Property, Motors, Jobs and Services, and get clean structured records with prices, locations, photos, listing specifics, and seller feedback. ### Why this scraper - Five sections in one tool: Marketplace, Property, Motors, Jobs, Services. Most tools cover only one. - Rich records: section-specific fields (bedrooms and land area for property, make, model, year and odometer for motors, salary for jobs) plus common fields shared across every section. - Seller and member feedback: positive and negative counts, feedback score, join date, and optional individual feedback comments, wherever Trade Me exposes them. - Two ways to search: keyword plus filters, or paste category, search, and individual listing links. - Collects results across as many result pages as needed, up to your item limit. - Optional export of results into the apps you already use through MCP connectors. - Predictable cost: pay per listing, with an optional detail surcharge only when you turn on full enrichment. ### Data you get > Sample shape, values are illustrative placeholders, not from a live listing. | Field | Example | | --- | --- | | vertical | `marketplace` | | listingId | `0000000001` | | title | `Sample Listing Title` | | priceDisplay | `$1,234` | | startPrice | `1234` | | buyNowPrice | `1500` | | region | `Auckland` | | suburb | `Sample Suburb` | | district | `Sample District` | | category | `Computers > Laptops` | | make | `SampleMake` | | model | `SampleModel` | | year | `2020` | | odometer | `50000` | | address | `1 Example Street, Sample Suburb` | | bedrooms | `3` | | bathrooms | `2` | | propertyType | `House` | | agencyName | `Sample Agency` | | agents | `[{ "name": "Agent Name", "mobilePhone": "+64000000000", "email": "agent@example.com" }]` | | sellerType | `member` | | memberId | `0000000` | | sellerFeedback | `{ "uniquePositive": 100, "uniqueNegative": 1, "feedbackPercent": 99, "isSuperSeller": true }` | | photoUrls | `["https://trademe.tmcdn.co.nz/photoserver/full/000000000.jpg"]` | | url | `https://www.trademe.co.nz/Browse/Listing.aspx?id=0000000001` | | scrapedAt | `2026-01-01T00:00:00.000Z` | ### How to use Search Marketplace by keyword: ```json { "vertical": "marketplace", "mode": "search", "queries": ["iphone"], "maxItems": 50 } ```` Search Property with filters and full detail plus seller feedback: ```json { "vertical": "property", "mode": "search", "listingType": "residential-sale", "region": "auckland", "minBedrooms": 3, "minPrice": 800000, "maxPrice": 1500000, "fetchDetails": true, "maxItems": 40 } ``` Search Motors with vehicle filters: ```json { "vertical": "motors", "mode": "search", "make": "Toyota", "model": "Corolla", "minYear": 2015, "maxPrice": 20000, "maxItems": 30 } ``` Paste links (category, search, or individual listings): ```json { "mode": "url", "startUrls": [ "https://www.trademe.co.nz/a/property/residential/sale", "https://www.trademe.co.nz/a/motors/used-cars" ], "maxItems": 40 } ``` ### Input parameters | Parameter | Type | Default | Description | | --- | --- | --- | --- | | vertical | string | `marketplace` | Which section: marketplace, property, motors, jobs, services | | mode | string | `search` | `search` (keywords + filters) or `url` (paste links) | | queries | array | `["iphone"]` | Keyword searches (search mode) | | keyword | string | | Extra free-text term | | sort | string | `Default` | Result ordering (applicability varies by section) | | listingType | string | `residential-sale` | Property market: residential-sale, residential-rent, commercial-sale, lifestyle | | region, district, suburb | string | | Location filters (property, jobs) | | propertyType | string | | Property type (property) | | minBedrooms, maxBedrooms, minBathrooms | integer | | Room filters (property) | | minLandArea, maxLandArea, minFloorArea, maxFloorArea | integer | | Area filters in m² (property) | | petsOkay | boolean | `false` | Pet-friendly rentals only (property) | | make, model | string | | Vehicle make and model (motors) | | minYear, maxYear | integer | | Year range (motors) | | minOdometer, maxOdometer | integer | | Odometer range (motors) | | bodyStyle, transmission, fuel | string | | Vehicle filters (motors) | | category | string | | Category id or slug (marketplace, jobs, services) | | condition | string | `Any` | Item condition (marketplace) | | buyNowOnly | boolean | `false` | Buy Now listings only (marketplace) | | jobType | string | | Job type (jobs) | | minPrice, maxPrice | integer | | Price range in NZD (salary for jobs) | | startUrls | array | | Category, search, or listing links (url mode) | | fetchDetails | boolean | `false` | Fetch full detail and seller feedback per listing | | includeMemberFeedbackComments | boolean | `false` | Also collect individual feedback comments (with fetchDetails) | | maxItems | integer | `20` | Main limit on listings (0 for unlimited) | | maxPages | integer | | Page safety limit; empty means no page limit, stops at Max items | | proxy | object | Apify default | Connection configuration | ### Send results into your apps (MCP connectors) You can optionally pipe each run's results into the apps you already use through Model Context Protocol (MCP) connectors, with no change to the dataset. 1. Authorize a connector under Apify, Settings, API & Integrations (for example Notion, Linear, Airtable, or Apify). 2. Select it in the "Export to your apps" input section. 3. For Notion, also set the parent page so each item becomes a page. The connector receives a condensed, human-readable summary per item (a title plus key fields), while the complete record always stays in the Apify dataset. ### Output example > Sample shape, values are illustrative placeholders, not from a live listing. ```json { "vertical": "property", "listingId": "0000000001", "title": "Sample Listing Title", "url": "https://www.trademe.co.nz/Browse/Listing.aspx?id=0000000001", "priceDisplay": "$1,234,000", "region": "Auckland", "suburb": "Sample Suburb", "district": "Sample District", "address": "1 Example Street, Sample Suburb", "bedrooms": 3, "bathrooms": 2, "propertyType": "House", "latitude": -36.0000, "longitude": 174.0000, "agencyName": "Sample Agency", "agents": [ { "name": "Agent Name", "mobilePhone": "+64000000000", "email": "agent@example.com" } ], "memberId": "0000000", "sellerFeedback": { "nickname": "sample_seller", "uniquePositive": 100, "uniqueNegative": 1, "feedbackPercent": 99, "isSuperSeller": true }, "photoUrls": ["https://trademe.tmcdn.co.nz/photoserver/full/000000000.jpg"], "scrapedAt": "2026-01-01T00:00:00.000Z" } ``` ### Notes Use an Apify account to run the actor. The default connection works well; residential is optional and not required. Run a small `maxItems` first to preview the shape of the data for your section and filters. # Actor input Schema ## `vertical` (type: `string`): Which Trade Me section to scrape: Marketplace (general goods and auctions), Property, Motors (vehicles), Jobs, or Services. ## `mode` (type: `string`): Search mode uses keywords and filters. URL mode scrapes category, search or individual listing links you paste. ## `queries` (type: `array`): One or more keyword searches within the selected section (for example: iphone, mountain bike). Leave empty to browse the whole section or a category. ## `keyword` (type: `string`): Optional free-text term applied on top of the section and filters. ## `sort` (type: `string`): Result ordering. Applicability varies by section: Marketplace supports Default, FeaturedFirst, PriceAsc, PriceDesc, TitleAsc, ExpiryAsc, ExpiryDesc, BidsMost, BuyNowPrice; Jobs supports BestMatch, JobsLatestListingDesc, HighestSalary, LowestSalary; Services supports ReviewsDesc. Leave as Default if unsure. ## `listingType` (type: `string`): Property section only. Which property market to search. ## `region` (type: `string`): Property or Jobs section. Region name or id (for example: auckland, wellington, canterbury). ## `district` (type: `string`): Property or Jobs section. District within the region. ## `suburb` (type: `string`): Property section. Suburb within the district. ## `propertyType` (type: `string`): Property section. For example: House, Apartment, Townhouse, Unit, Section, Lifestyle. ## `minBedrooms` (type: `integer`): Property section. Minimum number of bedrooms. ## `maxBedrooms` (type: `integer`): Property section. Maximum number of bedrooms. ## `minBathrooms` (type: `integer`): Property section. Minimum number of bathrooms. ## `minLandArea` (type: `integer`): Property section. Minimum land area in square metres. ## `maxLandArea` (type: `integer`): Property section. Maximum land area in square metres. ## `minFloorArea` (type: `integer`): Property section. Minimum floor area in square metres. ## `maxFloorArea` (type: `integer`): Property section. Maximum floor area in square metres. ## `petsOkay` (type: `boolean`): Property section (rentals). Only listings that allow pets. ## `make` (type: `string`): Motors section. For example: Toyota, Ford, Mazda. ## `model` (type: `string`): Motors section. For example: Corolla, Ranger. ## `minYear` (type: `integer`): Motors section. Earliest manufacture year. ## `maxYear` (type: `integer`): Motors section. Latest manufacture year. ## `minOdometer` (type: `integer`): Motors section. Minimum odometer reading. ## `maxOdometer` (type: `integer`): Motors section. Maximum odometer reading. ## `bodyStyle` (type: `string`): Motors section. For example: Hatchback, Sedan, SUV, Ute. ## `transmission` (type: `string`): Motors section. For example: Automatic, Manual. ## `fuel` (type: `string`): Motors section. For example: Petrol, Diesel, Electric, Hybrid. ## `category` (type: `string`): Marketplace, Jobs or Services section. Category id or slug to narrow the search. ## `condition` (type: `string`): Marketplace section. Item condition. ## `buyNowOnly` (type: `boolean`): Marketplace section. Only listings with a Buy Now price. ## `jobType` (type: `string`): Jobs section. For example: Full time, Part time, Contract. ## `minPrice` (type: `integer`): Minimum price in NZD (or minimum salary for Jobs). ## `maxPrice` (type: `integer`): Maximum price in NZD (or maximum salary for Jobs). ## `startUrls` (type: `array`): Trade Me category, search-result or individual listing URLs. Results continue from the page number in the URL onward. ## `fetchDetails` (type: `boolean`): Fetch each listing's full detail page and the seller's member feedback (positive/negative counts and score). Slower and adds a per-item detail charge. ## `includeMemberFeedbackComments` (type: `boolean`): When full details are enabled, also collect the seller's individual feedback comments. ## `maxItems` (type: `integer`): Maximum number of listings to return. This is the main limit. Set 0 for unlimited. ## `maxPages` (type: `integer`): Safety limit on result pages per search. Leave empty for no page limit; the run stops at Max items. ## `proxy` (type: `object`): Connection configuration. The default is recommended. ## `mcpConnectors` (type: `array`): Optionally send results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a page per item; other connectors get a best-effort write. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "vertical": "marketplace", "mode": "search", "queries": [ "iphone" ], "sort": "Default", "listingType": "residential-sale", "petsOkay": false, "condition": "", "buyNowOnly": false, "startUrls": [ "https://www.trademe.co.nz/a/property/residential/sale" ], "fetchDetails": false, "includeMemberFeedbackComments": false, "maxItems": 20, "proxy": { "useApifyProxy": true }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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": [ "iphone" ], "startUrls": [ "https://www.trademe.co.nz/a/property/residential/sale" ], "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/trademe-co-nz-scraper").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": ["iphone"], "startUrls": ["https://www.trademe.co.nz/a/property/residential/sale"], "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/trademe-co-nz-scraper").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": [ "iphone" ], "startUrls": [ "https://www.trademe.co.nz/a/property/residential/sale" ], "proxy": { "useApifyProxy": true } }' | apify call abotapi/trademe-co-nz-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/trademe-co-nz-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trade Me NZ Scraper – Marketplace, Property, Motors & Jobs", "description": "Scrape trademe.co.nz across all five sections: Marketplace goods and auctions, Property, Motors, Jobs and Services. Search or paste URLs, walk pagination, and enrich with full detail plus seller feedback (positive/negative counts and score).", "version": "1.0", "x-build-id": "y7uk2UBMXATrM8LaK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~trademe-co-nz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-trademe-co-nz-scraper", "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/abotapi~trademe-co-nz-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-trademe-co-nz-scraper", "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/abotapi~trademe-co-nz-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-trademe-co-nz-scraper", "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": [ "mode" ], "properties": { "vertical": { "title": "Section", "enum": [ "marketplace", "property", "motors", "jobs", "services" ], "type": "string", "description": "Which Trade Me section to scrape: Marketplace (general goods and auctions), Property, Motors (vehicles), Jobs, or Services.", "default": "marketplace" }, "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Search mode uses keywords and filters. URL mode scrapes category, search or individual listing links you paste.", "default": "search" }, "queries": { "title": "Keyword searches", "type": "array", "description": "One or more keyword searches within the selected section (for example: iphone, mountain bike). Leave empty to browse the whole section or a category.", "items": { "type": "string" } }, "keyword": { "title": "Extra keyword filter", "type": "string", "description": "Optional free-text term applied on top of the section and filters." }, "sort": { "title": "Sort order", "enum": [ "Default", "FeaturedFirst", "PriceAsc", "PriceDesc", "TitleAsc", "ExpiryAsc", "ExpiryDesc", "BidsMost", "BuyNowPrice", "BestMatch", "JobsLatestListingDesc", "HighestSalary", "LowestSalary", "ReviewsDesc" ], "type": "string", "description": "Result ordering. Applicability varies by section: Marketplace supports Default, FeaturedFirst, PriceAsc, PriceDesc, TitleAsc, ExpiryAsc, ExpiryDesc, BidsMost, BuyNowPrice; Jobs supports BestMatch, JobsLatestListingDesc, HighestSalary, LowestSalary; Services supports ReviewsDesc. Leave as Default if unsure.", "default": "Default" }, "listingType": { "title": "Property listing type", "enum": [ "residential-sale", "residential-rent", "commercial-sale", "lifestyle" ], "type": "string", "description": "Property section only. Which property market to search.", "default": "residential-sale" }, "region": { "title": "Region", "type": "string", "description": "Property or Jobs section. Region name or id (for example: auckland, wellington, canterbury)." }, "district": { "title": "District", "type": "string", "description": "Property or Jobs section. District within the region." }, "suburb": { "title": "Suburb", "type": "string", "description": "Property section. Suburb within the district." }, "propertyType": { "title": "Property type", "type": "string", "description": "Property section. For example: House, Apartment, Townhouse, Unit, Section, Lifestyle." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Property section. Minimum number of bedrooms." }, "maxBedrooms": { "title": "Max bedrooms", "minimum": 0, "type": "integer", "description": "Property section. Maximum number of bedrooms." }, "minBathrooms": { "title": "Min bathrooms", "minimum": 0, "type": "integer", "description": "Property section. Minimum number of bathrooms." }, "minLandArea": { "title": "Min land area (m²)", "minimum": 0, "type": "integer", "description": "Property section. Minimum land area in square metres." }, "maxLandArea": { "title": "Max land area (m²)", "minimum": 0, "type": "integer", "description": "Property section. Maximum land area in square metres." }, "minFloorArea": { "title": "Min floor area (m²)", "minimum": 0, "type": "integer", "description": "Property section. Minimum floor area in square metres." }, "maxFloorArea": { "title": "Max floor area (m²)", "minimum": 0, "type": "integer", "description": "Property section. Maximum floor area in square metres." }, "petsOkay": { "title": "Pets okay", "type": "boolean", "description": "Property section (rentals). Only listings that allow pets.", "default": false }, "make": { "title": "Vehicle make", "type": "string", "description": "Motors section. For example: Toyota, Ford, Mazda." }, "model": { "title": "Vehicle model", "type": "string", "description": "Motors section. For example: Corolla, Ranger." }, "minYear": { "title": "Min year", "minimum": 1900, "type": "integer", "description": "Motors section. Earliest manufacture year." }, "maxYear": { "title": "Max year", "minimum": 1900, "type": "integer", "description": "Motors section. Latest manufacture year." }, "minOdometer": { "title": "Min odometer (km)", "minimum": 0, "type": "integer", "description": "Motors section. Minimum odometer reading." }, "maxOdometer": { "title": "Max odometer (km)", "minimum": 0, "type": "integer", "description": "Motors section. Maximum odometer reading." }, "bodyStyle": { "title": "Body style", "type": "string", "description": "Motors section. For example: Hatchback, Sedan, SUV, Ute." }, "transmission": { "title": "Transmission", "type": "string", "description": "Motors section. For example: Automatic, Manual." }, "fuel": { "title": "Fuel type", "type": "string", "description": "Motors section. For example: Petrol, Diesel, Electric, Hybrid." }, "category": { "title": "Category", "type": "string", "description": "Marketplace, Jobs or Services section. Category id or slug to narrow the search." }, "condition": { "title": "Condition", "enum": [ "", "New", "Used" ], "type": "string", "description": "Marketplace section. Item condition.", "default": "" }, "buyNowOnly": { "title": "Buy Now only", "type": "boolean", "description": "Marketplace section. Only listings with a Buy Now price.", "default": false }, "jobType": { "title": "Job type", "type": "string", "description": "Jobs section. For example: Full time, Part time, Contract." }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price in NZD (or minimum salary for Jobs)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price in NZD (or maximum salary for Jobs)." }, "startUrls": { "title": "URLs", "type": "array", "description": "Trade Me category, search-result or individual listing URLs. Results continue from the page number in the URL onward.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full details + seller feedback", "type": "boolean", "description": "Fetch each listing's full detail page and the seller's member feedback (positive/negative counts and score). Slower and adds a per-item detail charge.", "default": false }, "includeMemberFeedbackComments": { "title": "Include individual feedback comments", "type": "boolean", "description": "When full details are enabled, also collect the seller's individual feedback comments.", "default": false }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return. This is the main limit. Set 0 for unlimited.", "default": 20 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 500, "type": "integer", "description": "Safety limit on result pages per search. Leave empty for no page limit; the run stops at Max items." }, "proxy": { "title": "Connection", "type": "object", "description": "Connection configuration. The default is recommended.", "default": { "useApifyProxy": true } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a page per item; other connectors get a best-effort write. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```