{ "openapi": "3.0.1", "info": { "title": "Carter Vintage Guitars Scraper - Inventory & Prices", "description": "Scrape Carter Vintage Guitars (Nashville vintage guitar shop). Get title, brand, model, year, condition, price, availability, SKU, images and URL for every listing. Filter by keyword, category, brand or price sort. For vintage guitar price tracking, dealers and collectors.", "version": "1.0", "x-build-id": "EDqwrDyQPMYGEBkqZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lulzasaur~cartervintage-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lulzasaur-cartervintage-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/lulzasaur~cartervintage-scraper/runs": { "post": { "operationId": "runs-sync-lulzasaur-cartervintage-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/lulzasaur~cartervintage-scraper/run-sync": { "post": { "operationId": "run-sync-lulzasaur-cartervintage-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 Keywords", "type": "array", "description": "Keywords to search the inventory (e.g. 'Stratocaster', 'Les Paul', '1959'). Leave EMPTY to browse the entire catalog.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "Electric Guitars", "Solid Body", "Hollow and Semi-Hollow Body", "Acoustic Guitars", "Dreadnought", "OM and Auditorium", "Parlor and Small Body", "Jumbo", "Classical Nylon", "Bass Guitars", "Archtop Guitars", "Amplifiers", "Pedals and Effects", "Ukuleles", "Banjos", "Mandolins", "Lap and Pedal Steel Guitars", "Resonator", "Dobros", "Accessories", "Strings", "Straps", "Cases", "Capos", "Picks", "Slides", "Cables" ], "type": "string", "description": "Filter by category. Leave as 'Any' to include all categories.", "default": "" }, "brand": { "title": "Brand", "type": "string", "description": "Filter by exact brand name (e.g. 'Fender', 'Gibson', 'Martin', 'Gretsch', 'Rickenbacker'). Leave empty for all brands.", "default": "" }, "inStockOnly": { "title": "In-Stock Only", "type": "boolean", "description": "Only return listings currently in stock. Turn OFF to also include sold/unavailable listings (useful for sold-price research).", "default": true }, "sort": { "title": "Sort Order", "enum": [ "LISTING_TIME_DESC", "LISTING_TIME_ASC", "PRICE_ASC", "PRICE_DESC", "DEFAULT" ], "type": "string", "description": "How to sort results.", "default": "LISTING_TIME_DESC" }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape across all queries. Set to 0 for unlimited (walks the whole catalog).", "default": 100 }, "scrapeDetails": { "title": "Scrape Item Details", "type": "boolean", "description": "Fetch each item's detail record to add full description, country of origin and materials (body/neck/fretboard/top/back woods). Slower — one extra request per item.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. The Carter Vintage backend is open and works with NO proxy by default. Enable a proxy only if you hit rate limits.", "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 } } } } } } } } } }