{ "openapi": "3.0.1", "info": { "title": "Telegram Marketplace Ads — Rentals, Sales, Jobs & Services", "description": "Search dated public Telegram classifieds by country, type and keywords. Get price, explicit price period when known, city, direction and the original message link. Offers and wanted ads are labeled separately.", "version": "1.0", "x-build-id": "bRORIeyZnfi1sJgXp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/telegrambest~telegram-classifieds/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-telegrambest-telegram-classifieds", "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/telegrambest~telegram-classifieds/runs": { "post": { "operationId": "runs-sync-telegrambest-telegram-classifieds", "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/telegrambest~telegram-classifieds/run-sync": { "post": { "operationId": "run-sync-telegrambest-telegram-classifieds", "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": { "country": { "title": "Country", "enum": [ "", "ae", "th", "tr", "vn", "ru", "us" ], "type": "string", "description": "Where the ads are posted.", "default": "ae" }, "listingType": { "title": "Type", "enum": [ "", "rent", "sale", "job", "service", "event" ], "type": "string", "description": "Which kind of ads: rent, sale, job or service. Any — all kinds.", "default": "rent" }, "direction": { "title": "Offers or requests", "enum": [ "", "offer", "wanted" ], "type": "string", "description": "'Offer' — someone rents out, sells, hires or offers a service. 'Wanted' — someone is looking for it.", "default": "" }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional. Every word must appear in the title, city or category — e.g. 'Marina', 'studio', 'Pattaya', 'scooter'.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Optional. Category slugs as they appear in the results, e.g. 'condo', 'villa', 'room', 'car', 'scooter', 'electronics', 'driver', 'cleaning'.", "items": { "type": "string" } }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 60, "type": "integer", "description": "Only ads posted in the last N days (up to 60).", "default": 14 }, "maxResults": { "title": "Max listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Newest first. You pay only for listings delivered. On the Apify free plan a run returns at most 50.", "default": 100 }, "onlyNew": { "title": "Only listings I have not received before", "type": "boolean", "description": "Skip (and do not charge for) listings delivered to this account in earlier runs — schedule it hourly for a live feed.", "default": 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 }, "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 } } } } } } } } } }