{ "openapi": "3.0.1", "info": { "title": "Swappa Scraper: iPhone, MacBook, Galaxy Prices", "description": "Get current used and refurbished iPhone, MacBook, Samsung Galaxy, Google Pixel, and other Swappa.com listings in your spreadsheet in under 60 seconds. Prices, conditions, storage, carrier, seller ratings, and full descriptions.", "version": "0.1", "x-build-id": "3HmH9r0TFOdAuAxZS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~swappa-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-swappa-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/getascraper~swappa-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-swappa-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/getascraper~swappa-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-swappa-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", "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Fuzzy-match terms (e.g. 'iPhone 14' maps to '/listings/apple-iphone-14'). Leave blank if using direct Start URLs.", "default": [ "iPhone 14" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Swappa listings URLs (e.g. 'https://swappa.com/listings/apple-iphone-15'). Bypasses search mapping completely.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "category": { "title": "Category filter", "enum": [ "all", "iphones", "macbooks", "galaxy", "ipads", "watches", "consoles" ], "type": "string", "description": "Narrow search queries to a specific device class (e.g. iPhones, MacBooks, iPads).", "default": "all" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only include devices priced at or above this value. 0 = no minimum.", "default": 0 }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only include devices priced at or below this value. 0 = no maximum.", "default": 0 }, "carrier": { "title": "Carrier filter", "enum": [ "any", "unlocked", "verizon", "att", "t-mobile", "sprint", "xfinity" ], "type": "string", "description": "Restrict to listings under this cellular network.", "default": "any" }, "condition": { "title": "Device condition", "enum": [ "any", "mint", "good", "fair", "poor" ], "type": "string", "description": "Restrict to listings matching this physical condition grade.", "default": "any" }, "dataSource": { "title": "Fetching mode", "enum": [ "wayback", "auto", "live" ], "type": "string", "description": "Where to pull listings from. Wayback Machine is unblocked and costs $0 in proxies. Live storefront is often blocked.", "default": "wayback" }, "scrapeDetails": { "title": "Enrich detail pages", "type": "boolean", "description": "Fetch individual listing detail pages in parallel for JSON-LD specs. Note: this is slower and multiplies requests.", "default": false }, "maxItems": { "title": "Maximum results", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of listings to output per category (0 = unlimited).", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel requests (1-20). Higher is faster but may trigger CDX rate limits.", "default": 5 }, "debugLogging": { "title": "Verbose debug logs", "type": "boolean", "description": "Print granular tracing tags (WAYBACK-CDX, WAYBACK-FETCH, EMIT) to the run logs.", "default": false }, "proxyConfiguration": { "title": "Proxy setup", "type": "object", "description": "Proxy options. Required only if fetching from the live Swappa storefront.", "default": { "useApifyProxy": 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 } } } } } } } } } }