{
  "openapi": "3.0.1",
  "info": {
    "title": "Latin America Public Tenders: Colombia, Brazil, Chile & more",
    "description": "Returns Latin America public tenders (licitaciones) from Colombia, Brazil, Chile, Paraguay, Uruguay: buyer, deadline, USD amount, winner. Pay per result.",
    "version": "1.1",
    "x-build-id": "1XmxCFEqPexbv7wuq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/cleanyield~latam-public-tenders/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-cleanyield-latam-public-tenders",
        "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/cleanyield~latam-public-tenders/runs": {
      "post": {
        "operationId": "runs-sync-cleanyield-latam-public-tenders",
        "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/cleanyield~latam-public-tenders/run-sync": {
      "post": {
        "operationId": "run-sync-cleanyield-latam-public-tenders",
        "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": {
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Which official sources to search: CO = Colombia (SECOP II on datos.gov.co), BR = Brazil (PNCP, Portal Nacional de Contratações Públicas), CL = Chile (Mercado Público / ChileCompra OCDS API), PY = Paraguay (DNCP OCDS API), UY = Uruguay (ARCE OCDS open data). Leave empty for CO, BR and CL. Uruguay has no keyword search in its API (each new call is read one by one): wide date ranges are slower there. Example: [\"CO\", \"PY\"].",
            "items": {
              "type": "string",
              "enum": [
                "CO",
                "BR",
                "CL",
                "PY",
                "UY"
              ],
              "enumTitles": [
                "Colombia (SECOP II)",
                "Brazil (PNCP)",
                "Chile (Mercado Público)",
                "Paraguay (DNCP)",
                "Uruguay (ARCE)"
              ]
            }
          },
          "sectors": {
            "title": "Sectors (ready-made keyword + UNSPSC packs)",
            "type": "array",
            "description": "Pick your sector and the Actor matches tenders in Spanish and Portuguese for you (accents ignored), using sector keywords in the title and UNSPSC codes of the main category. Combine with your own keywords. Example: [\"it-software\"] finds software licences, computers, IT services in all three countries.",
            "items": {
              "type": "string",
              "enum": [
                "it-software",
                "construction",
                "cleaning",
                "security",
                "medical",
                "food",
                "vehicles",
                "office-supplies",
                "consulting",
                "telecom",
                "energy",
                "events-travel",
                "training-education",
                "uniforms-ppe",
                "waste-environment"
              ],
              "enumTitles": [
                "IT, software & computers",
                "Construction & public works",
                "Cleaning & facility services",
                "Security & surveillance",
                "Medical supplies, drugs & lab",
                "Food & catering",
                "Vehicles, parts, tyres & fuel",
                "Office supplies & furniture",
                "Consulting, audit & engineering studies",
                "Telecom & connectivity",
                "Electrical, lighting & solar energy",
                "Events, travel & lodging",
                "Training & education services",
                "Uniforms, workwear & PPE",
                "Waste management & environment"
              ]
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Words or phrases to find in the tender title, description, category or items (any of them matches; accents and upper/lower case are ignored; matches the start of a word, so 'licencia' also finds 'licencias'). Write them in Spanish for CO/CL/PY/UY and Portuguese for BR. Example: [\"ambulancia\", \"ambulância\", \"vigilancia\"].",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Tenders containing any of these words are dropped (noise filter). Example: [\"arrendamiento\", \"locação\"].",
            "items": {
              "type": "string"
            }
          },
          "categoryCodes": {
            "title": "UNSPSC category codes",
            "type": "array",
            "description": "UNSPSC codes or prefixes (2, 4, 6 or 8 digits) of the tender's main category: 43 = IT and telecom, 4321 = computers, 72 = construction services, 80111600 = temporary staff. Chile classifies every tender with UNSPSC; Colombia rarely does for open tenders; Brazil does not use UNSPSC (use keywords). When combined with keywords, a tender matches if either matches.",
            "items": {
              "type": "string"
            }
          },
          "buyers": {
            "title": "Buying entities",
            "type": "array",
            "description": "Only tenders from these buyers: part of the name (accents ignored, e.g. 'Universidad Nacional', 'Prefeitura de São Paulo') or tax ID (NIT for Colombia, CNPJ for Brazil, RUT for Chile). Example: [\"899999063\", \"ministerio de obras publicas\"].",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "Buyer location: Colombian department or city (e.g. 'Antioquia', 'Bogotá'), Brazilian state (2-letter code like 'SP' or name), Chilean region (e.g. 'Valparaíso', 'Metropolitana'). Leave empty for the whole country.",
            "items": {
              "type": "string"
            }
          },
          "minAmountUsd": {
            "title": "Minimum estimated amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only tenders whose estimated budget (or awarded amount) is at least this many US dollars, converted from COP/BRL/CLP with today's exchange rate. Tenders without a published amount are excluded when you set this. Example: 50000."
          },
          "maxAmountUsd": {
            "title": "Maximum estimated amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only tenders whose estimated budget is at most this many US dollars (e.g. 200000 for SMEs). Tenders without a published amount are excluded when you set this."
          },
          "status": {
            "title": "Status",
            "type": "array",
            "description": "Normalized status across countries: open (accepting bids), closed (bidding closed, under evaluation), awarded, cancelled, unsuccessful (no valid bids / 'desierta'), suspended, unknown. Default: open. Leave empty for any status. Example: [\"awarded\"] to study who wins.",
            "items": {
              "type": "string",
              "enum": [
                "open",
                "closed",
                "awarded",
                "cancelled",
                "unsuccessful",
                "suspended",
                "unknown"
              ]
            },
            "default": [
              "open"
            ]
          },
          "procurementScope": {
            "title": "Procedure scope",
            "enum": [
              "competitive",
              "all"
            ],
            "type": "string",
            "description": "competitive (default) = only procedures any supplier can bid on: public tenders, reverse auctions (pregão, subasta inversa), small-value open calls, merit contests, restricted tenders. all = also direct awards, exemptions (dispensa, inexigibilidade, contratación directa), requests for information and asset sales.",
            "default": "competitive"
          },
          "procedureTypes": {
            "title": "Procedure types",
            "type": "array",
            "description": "Optional filter by normalized procedure type, e.g. [\"reverse-auction\"] for pregão eletrônico / subasta inversa, [\"public-tender\"] for licitación pública / concorrência. Leave empty for all types in the chosen scope.",
            "items": {
              "type": "string",
              "enum": [
                "public-tender",
                "reverse-auction",
                "abbreviated",
                "small-value",
                "merit-contest",
                "restricted",
                "competitive-dialogue",
                "direct-with-quotes",
                "direct",
                "framework",
                "rfi",
                "auction-sale",
                "other"
              ]
            }
          },
          "publishedWithinDays": {
            "title": "Published in the last N days",
            "minimum": 0,
            "maximum": 366,
            "type": "integer",
            "description": "Tenders published in the last N days (default 7). Keep 7 for a daily monitor: Colombia's open data arrives with a 1–4 day delay (tenders show up later with their original publication date) and the overlap is free in monitor mode (already-sent tenders are not charged again). Ignored if 'Published since' is set. Example: 7.",
            "default": 7
          },
          "publishedSince": {
            "title": "Published since (date)",
            "type": "string",
            "description": "Absolute start date YYYY-MM-DD (buyer's local date). Overrides 'Published in the last N days'. Example: 2026-10-01."
          },
          "publishedUntil": {
            "title": "Published until (date)",
            "type": "string",
            "description": "Optional end date YYYY-MM-DD (buyer's local date, inclusive). Leave empty for 'up to today'."
          },
          "closingFrom": {
            "title": "Closing date from",
            "type": "string",
            "description": "Only tenders whose bid deadline is on or after this date (YYYY-MM-DD). Example: 2026-11-10."
          },
          "closingTo": {
            "title": "Closing date to",
            "type": "string",
            "description": "Only tenders whose bid deadline is on or before this date (YYYY-MM-DD), e.g. to see what closes this month."
          },
          "tenderIds": {
            "title": "Tender IDs (lookup)",
            "type": "array",
            "description": "Look up specific tenders instead of searching (search filters are ignored). Accepts the tenderId from this Actor's output or the id shown on each portal: CO1.REQ.11304903 (SECOP II), 88124961000159-1-000131/2026 (PNCP 'Id contratação PNCP'), 5751-39-LR26 (Mercado Público), ocds-03ad3f-490443-1 (DNCP Paraguay), UY-1384146 (ARCE Uruguay, 'UY-' + purchase id). Ids that don't exist are reported and not charged.",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many tenders (shared fairly between countries). Caps your cost: you pay only for tenders actually returned. In monitor mode it caps new/changed tenders. Example: 100.",
            "default": 100
          },
          "includeAwardees": {
            "title": "Include awardees",
            "type": "boolean",
            "description": "For awarded tenders, add who won and for how much (company name, tax ID, amount). Costs one extra request per awarded tender in Chile and a few in Brazil (still one charged result). Default on.",
            "default": true
          },
          "awardeeData": {
            "title": "Awardee personal data",
            "enum": [
              "omitIndividuals",
              "include",
              "omit"
            ],
            "type": "string",
            "description": "Awardees can be individuals (sole traders). omitIndividuals (default) hides the name and ID of natural persons and keeps companies; include keeps everything published by the government; omit removes awardee names and IDs entirely.",
            "default": "omitIndividuals"
          },
          "includeDetails": {
            "title": "Include items and documents",
            "type": "boolean",
            "description": "Add the line items (description, quantity, unit, category, estimated value) and, for Brazil, the list of tender documents (edital, termo de referência) with direct links. Brazil needs 2 extra requests per tender, so runs are slower. Default off.",
            "default": false
          },
          "translateToEnglish": {
            "title": "English titles (titleEn / descriptionEn)",
            "type": "boolean",
            "description": "Adds an English translation of the title and description of each tender (AI, faithful, no extra charge). Turn off to skip it. If the AI is not available in a run, the fields are null.",
            "default": true
          },
          "proMode": {
            "title": "Pro mode (fit score, urgency, buyer profile, why-now, AI insight)",
            "type": "boolean",
            "description": "One checkbox for the bid-decision extras on every tender: a 0-100 fit score with its reasons (how well it matches your keywords, sectors and UNSPSC codes, and whether there is time to bid), days to close and urgency (critical = 2 days or less, high = this week), a buyer profile from your own monitoring history (tenders this buyer published since you started monitoring and its typical budget), a dated 'why now' line and a one-sentence AI insight. Charged as an extra 'pro-result' event per tender (see Pricing).",
            "default": false
          },
          "priorityKeywords": {
            "title": "Priority keywords (Pro)",
            "type": "array",
            "description": "Words that matter most to you (also searched like normal keywords). In Pro mode a tender that mentions one gets +15 fit points. Example: [\"licencias microsoft\", \"ciberseguridad\"].",
            "items": {
              "type": "string"
            }
          },
          "minFitScore": {
            "title": "Minimum fit score (Pro)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Pro mode only: tenders with a lower fit score are skipped and not charged. Leave empty to get every match ranked by fitScore."
          },
          "monitorMode": {
            "title": "Monitor mode (only new or changed tenders)",
            "type": "boolean",
            "description": "For scheduled runs: remember what was found last time and output only tenders that are new, plus tenders you already received whose deadline was extended or moved, that were awarded (with winner and amount), cancelled, suspended or declared unsuccessful, or whose estimated amount changed. Each item gets changeType (new/changed) and a changes list. You pay only for new/changed tenders. Schedule it daily.",
            "default": false
          },
          "monitorStateName": {
            "title": "Monitor state name",
            "type": "string",
            "description": "Optional name of the storage that keeps the previous results. Use the same name across scheduled runs to compare against them. Leave empty to derive it automatically from the rest of the input. Lowercase letters, numbers and hyphens only. Example: it-tenders-daily."
          },
          "trackChanges": {
            "title": "Re-check tenders already sent",
            "type": "boolean",
            "description": "Monitor mode: also re-check tenders you received before (that are not awarded/cancelled yet) for deadline extensions, awards, cancellations and amount changes, even if they no longer match the date window. Default on.",
            "default": true
          },
          "maxTrackedRechecks": {
            "title": "Max tenders re-checked per run",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Monitor mode: how many previously sent, still-open tenders are re-checked each run (oldest-checked first). Default 200. Re-checks are not charged; only real changes are.",
            "default": 200
          },
          "notifyWebhookUrl": {
            "title": "Webhook URL for alerts",
            "type": "string",
            "description": "Optional. When monitor mode finds new or changed tenders, POST a JSON summary to this URL (works with Zapier, Make, n8n; use it to send emails too). Example: https://hooks.zapier.com/hooks/catch/123/abc"
          },
          "notifySlackWebhookUrl": {
            "title": "Slack webhook URL for alerts",
            "type": "string",
            "description": "Optional. Slack incoming-webhook URL to receive one line per new/changed tender (title, buyer, amount, deadline, link). Example: https://hooks.slack.com/services/T000/B000/XXXX"
          },
          "alertCountries": {
            "title": "Alert only for these countries",
            "type": "array",
            "description": "Monitor mode: send Slack/webhook alerts only for tenders from these countries (the dataset still has every new or changed tender, with alert = true/false). Example: [\"CO\", \"PY\"].",
            "items": {
              "type": "string",
              "enum": [
                "CO",
                "BR",
                "CL",
                "PY",
                "UY"
              ],
              "enumTitles": [
                "Colombia",
                "Brazil",
                "Chile",
                "Paraguay",
                "Uruguay"
              ]
            }
          },
          "alertSectors": {
            "title": "Alert only for these sectors",
            "type": "array",
            "description": "Monitor mode: alert only for tenders of these ready-made sectors (same ids as 'Sectors'). Example: [\"medical\", \"it-software\"].",
            "items": {
              "type": "string",
              "enum": [
                "it-software",
                "construction",
                "cleaning",
                "security",
                "medical",
                "food",
                "vehicles",
                "office-supplies",
                "consulting",
                "telecom",
                "energy",
                "events-travel",
                "training-education",
                "uniforms-ppe",
                "waste-environment"
              ],
              "enumTitles": [
                "IT, software & computers",
                "Construction & public works",
                "Cleaning & facility services",
                "Security & surveillance",
                "Medical supplies, drugs & lab",
                "Food & catering",
                "Vehicles, parts, tyres & fuel",
                "Office supplies & furniture",
                "Consulting, audit & engineering studies",
                "Telecom & connectivity",
                "Electrical, lighting & solar energy",
                "Events, travel & lodging",
                "Training & education services",
                "Uniforms, workwear & PPE",
                "Waste management & environment"
              ]
            }
          },
          "alertMinAmountUsd": {
            "title": "Alert only above this amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Monitor mode: alert only for tenders whose estimated (or awarded) amount is at least this many US dollars. Tenders without a published amount do not alert. Example: 50000."
          },
          "savedListName": {
            "title": "Saved watchlist name",
            "type": "string",
            "description": "Give your keywords, sectors, UNSPSC codes, buyers and exclusions a name (e.g. my-it-watch) and the Actor remembers them: next runs (scheduled or not) use the saved list plus anything you add. Pair it with Monitor mode."
          },
          "saveList": {
            "title": "Save new items to the list",
            "type": "boolean",
            "description": "Add this run's keywords, sectors, codes, buyers and exclusions to the saved list (off = use the saved list without changing it).",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}