{ "openapi": "3.0.1", "info": { "title": "N11 Scraper: Ürün Fiyat, İndirim & Satıcı | Price Intelligence", "description": "Scrape n11.com (Türkiye) products with price, list price, 30-day lowest price, discount, seller, stock and delivery. Filter by sort, price, rating and brand, read whole categories past 1,000 results, track price drops on a schedule. Ürün fiyat takibi. No login.", "version": "0.2", "x-build-id": "qlaDDO526nFUCJEkf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~n11-product-search-intelligence-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-n11-product-search-intelligence-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~n11-product-search-intelligence-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-n11-product-search-intelligence-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~n11-product-search-intelligence-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-n11-product-search-intelligence-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": { "productUrls": { "title": "Product links or IDs", "type": "array", "description": "N11 product page links or the numeric ID at the end of a product link. Each one returns a full product record with specifications, variants and other sellers. Leave empty to skip.", "items": { "type": "string" }, "default": [] }, "sellerUrls": { "title": "Seller shop links or names", "type": "array", "description": "N11 seller shop links (www.n11.com/magaza/name) or just the shop name. Returns that seller's whole catalogue and a seller profile in the run files.", "items": { "type": "string" }, "default": [] }, "startUrls": { "title": "Search or category page links", "type": "array", "description": "N11 search results or category pages, for example a category you opened in the browser with brand or price filters applied. Product and seller links added here are routed automatically.", "items": { "type": "object", "properties": { "url": { "title": "N11 URL", "type": "string", "description": "A public search or category page on n11.com.", "pattern": "^https://(www\\.)?n11\\.com/" } }, "required": [ "url" ] }, "default": [] }, "searchQueries": { "title": "Search keywords", "maxItems": 25, "type": "array", "description": "Turkish or other keywords to search on N11, one per row. The prefilled example keyword is ignored as soon as you add links, sellers or products above.", "items": { "type": "string", "maxLength": 100 }, "default": [ "telefon" ] }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "priceAsc", "priceDesc", "bestSelling", "mostReviewed", "newest" ], "type": "string", "description": "Order of the results on N11. Rank positions in the output follow this order.", "default": "relevance" }, "priceMin": { "title": "Minimum price (TRY)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only products priced at or above this amount in Turkish lira." }, "priceMax": { "title": "Maximum price (TRY)", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only products priced at or below this amount in Turkish lira." }, "brands": { "title": "Brands", "maxItems": 10, "type": "array", "description": "Keep only these brands, one per row (for example Samsung). Each brand is searched separately for every keyword.", "items": { "type": "string", "maxLength": 60 }, "default": [] }, "minRating": { "title": "Minimum product rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only products rated at least this many stars out of 5 by buyers." }, "minSellerScore": { "title": "Minimum seller score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only products from sellers with at least this N11 seller score (0 to 100)." }, "minReviewCount": { "title": "Minimum number of reviews", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop products with fewer buyer reviews than this, which filters out untested listings." }, "minDiscountPercent": { "title": "Minimum discount (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Keep only products whose price is at least this percent below the list price shown by N11." }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Keep only products that ship for free.", "default": false }, "officialSellersOnly": { "title": "Official sellers only", "type": "boolean", "description": "Keep only products sold by N11 authorized (Yetkili) stores.", "default": false }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Add the sponsored products N11 shows above the results. They are marked as sponsored and have no rank.", "default": false }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Open every product page to add specifications, barcode, variants, rating breakdown, review highlights, delivery details and a comparison of other sellers. Slower and billed as an add-on per product.", "default": false }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Total products to return across all sources. Searches above 1,000 matches are split into price bands automatically, so large pulls work. Free-plan runs are capped at 25.", "default": 20 }, "maxItemsPerSource": { "title": "Maximum products per keyword or link", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Optional cap for each keyword, category link or seller, so one broad search cannot use up the whole total." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Give this search a name to remember it between runs. The run then marks every product as new, price drop, price rise, back in stock, out of stock, removed or unchanged. Reuse the same name on a schedule." }, "onlyChanges": { "title": "Only return changes", "type": "boolean", "description": "With a monitor name, return only products that are new, changed or removed since the previous run, and pay only for those.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave empty for the built-in connection, which switches to a Turkish residential route by itself if N11 refuses requests. Set a proxy only if you need your own." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }