{ "openapi": "3.0.1", "info": { "title": "Yandex Images Scraper", "description": "Search Yandex Images and get every result as a clean row: full-size picture address, pixel size, file size, thumbnail, title and the page it appears on. Filter by size, shape and picture type. Around 1,200 different pictures per search term, with repeats reported once.", "version": "0.0", "x-build-id": "ZdNhWueDFxSl0gcVC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~yandex-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-yandex-images-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/apt_marble~yandex-images-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-yandex-images-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/apt_marble~yandex-images-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-yandex-images-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": [ "queries" ], "properties": { "queries": { "title": "Search terms", "type": "array", "description": "The terms to search for, up to 200 in one run. One row is produced for each different picture found. Terms in Russian return the richest results, because this is the largest Russian-language picture index — but any language works.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Images per search term", "minimum": 1, "maximum": 1500, "type": "integer", "description": "How many different pictures to collect for each search term. The source publishes about 1,200 different pictures for any one search, so a higher number simply collects everything it makes available.", "default": 100 }, "imageSize": { "title": "Image size", "enum": [ "any", "large", "medium", "small" ], "type": "string", "description": "Keep only pictures in this size class. Large returns roughly 1,200 px wide and up, medium roughly 700 px, small roughly 250 px. Leave on Any size to get the full mix.", "default": "any" }, "orientation": { "title": "Orientation", "enum": [ "any", "horizontal", "vertical", "square" ], "type": "string", "description": "Keep only pictures with this shape. Landscape and portrait are applied strictly; square is applied approximately, so a few near-square pictures can appear.", "default": "any" }, "imageType": { "title": "Image type", "enum": [ "any", "photo", "clipart", "lineart", "demotivator" ], "type": "string", "description": "Keep only one kind of picture: photographs, clipart, line drawings, or captioned poster images. Each returns a noticeably different set from the same search term.", "default": "any" }, "region": { "title": "Market", "enum": [ "", "225", "213", "2", "65", "54", "43", "47", "51", "66", "172", "35", "62", "56", "39", "193", "38", "50", "239", "149", "157", "159", "162", "163" ], "type": "string", "description": "Rank results the way people in this market see them. On picture search this is a ranking preference rather than a strict filter, so pictures from elsewhere can still appear. Every row records the market the source itself stated it answered for. Leave empty to use the source's own default.", "default": "" }, "maxConcurrency": { "title": "Search terms at a time", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search terms to work through at once. Raising this finishes a long list sooner; lowering it is gentler on the source and slightly more reliable on very large jobs.", "default": 3 } } }, "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 } } } } } } } } } }