{ "openapi": "3.0.1", "info": { "title": "SECOP II Colombia Tenders Scraper", "description": "Colombian public tenders from SECOP II: open tenders by default, with buyer, department, city, method, UNSPSC codes, estimated value, deadlines, days left and document links. Filter by keyword, buyer, region, method and date for daily tender alerts.", "version": "0.1", "x-build-id": "BN0pKXkm6pLNEy7Su" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automatic~secop-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automatic-secop-tenders-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/automatic~secop-tenders-scraper/runs": { "post": { "operationId": "runs-sync-automatic-secop-tenders-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/automatic~secop-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-automatic-secop-tenders-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": { "keywords": { "title": "Keywords", "type": "array", "description": "Words searched in the tender (title, description, buyer), accents optional, e.g. 'mantenimiento' or 'vigilancia'. Several keywords return tenders matching any of them. Up to 10.", "default": [], "items": { "type": "string" } }, "status": { "title": "Status", "enum": [ "open", "closed", "awarded", "cancelled", "all" ], "type": "string", "description": "open: still accepting offers (deadline today or later in Bogotá). closed, awarded, cancelled or all.", "default": "open" }, "publishedSince": { "title": "Published or changed since", "type": "string", "description": "Only tenders published or updated on or after this date (YYYY-MM-DD), or within a period such as 2 days. Use it for daily monitoring." }, "buyer": { "title": "Buyer", "type": "string", "description": "Buying entity: part of its name (case and accents ignored, e.g. 'policia') or its tax id (NIT, digits only).", "default": "" }, "department": { "title": "Department", "type": "string", "description": "Department (region) of the buyer, e.g. Antioquia, Valle del Cauca, Bogotá. Accents optional.", "default": "" }, "city": { "title": "City", "type": "string", "description": "City of the buyer, e.g. Medellín or Cali. Accents optional; the whole city name.", "default": "" }, "procurementMethods": { "title": "Procurement methods", "type": "array", "description": "Leave empty for every competitive method. Direct contracting and special-regime awards without offers are only returned when selected here.", "items": { "type": "string", "enum": [ "publicTender", "abbreviatedSelection", "reverseAuction", "meritContest", "minimumValue", "specialRegimeWithOffers", "directWithOffers", "informationRequest", "assetSale", "directContract", "specialRegime" ], "enumTitles": [ "Public tender (licitación pública)", "Abbreviated selection (menor cuantía)", "Reverse auction (subasta inversa)", "Merit contest (concurso de méritos)", "Minimum value (mínima cuantía)", "Special regime with offers", "Direct contracting with offers", "Request for information", "Sale of state assets", "Direct contracting (no competition)", "Special regime (no competition)" ] }, "default": [] }, "categoryCodes": { "title": "UNSPSC category codes", "type": "array", "description": "UNSPSC code prefixes, 2 to 8 digits, e.g. 72 (construction) or 81112000. Only tenders whose buyer published a matching code are returned.", "default": [], "items": { "type": "string" } }, "minEstimatedValue": { "title": "Minimum estimated value (COP)", "minimum": 0, "type": "integer", "description": "Only tenders with a published estimated value of at least this many pesos." }, "sort": { "title": "Sort", "enum": [ "newest", "deadlineSoonest" ], "type": "string", "description": "Order of the results.", "default": "newest" }, "maxItems": { "title": "Max tenders", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum tenders to return.", "default": 50 }, "includeDetails": { "title": "Include documents and description", "type": "boolean", "description": "Add the tender documents (download links) and a description excerpt to each row. Slightly slower.", "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 } } } } } } } } } }