# Colombia SECOP Scraper (`scrapers_lat/colombia-secop-scraper`) Actor
Extract Colombia public contracts from SECOP II (datos.gov.co): entity and supplier, NIT, contract value, amounts paid and invoiced, legal representative ID, supplier bank and account, UNSPSC category, supervisor and spending authority.
- **URL**: https://apify.com/scrapers\_lat/colombia-secop-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $8.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/giqQ1MgUnf7AfOrFd/input)
## Colombia SECOP Scraper
> Extract Colombian public procurement contracts from the official SECOP II open-data portal, covering government buyers and awarded suppliers across all 33 departments
41 fields per record
Colombia coverage
JSON / CSV / Excel output formats
Updated 2026-06-22
### What you get
Each record is one electronic contract pulled straight from Colombia's SECOP II (Sistema Electrónico para la Contratación Pública) on the datos.gov.co open-data portal, linking the contracting government entity to the awarded supplier, with the contract object, value, payment financials, supplier banking and legal-representative details, plus the supervisor and spending authority. Useful for supplier lead generation, KYC, competitor and contract intelligence, and public-spending analysis.
- **entity**: contracting government entity (buyer) name
- **entityNit**: tax identifier (NIT) of the contracting entity
- **supplier**: awarded supplier or contractor name (company or individual)
- **supplierNit**: supplier document number (NIT for companies, cédula for individuals)
- **supplierDocType**: type of supplier document (NIT, Cédula de Ciudadanía and others)
- **isPyme**: whether the supplier is registered as a small or medium enterprise
- **contractRef**: the entity's internal contract reference number
- **contractId**: the unique SECOP contract identifier
- **object**: full description of the contract object (what is being contracted)
- **contractType**: type of contract (Obra, Prestación de servicios, Compraventa and others)
- **modality**: contracting modality (Licitación pública, Contratación directa and others)
- **status**: current contract status (En ejecución, terminado, Aprobado and others)
- **value**: contract value
- **currency**: currency of the value (COP)
- **department**: Colombian department where the contract is executed
- **city**: city where the contract is executed
- **sector**: economic sector of the contracting entity
- **entityOrder**: government level of the entity (Nacional or Territorial)
- **categoryCode**: UNSPSC code of the main procurement category
- **amountPaid**: amount paid to the supplier so far
- **amountInvoiced**: amount invoiced by the supplier
- **amountPending**: amount still pending payment
- **amountPendingExecution**: contract value still pending execution
- **amountAmortized**: amortized amount on advance-payment contracts
- **legalRepresentative**: name of the supplier's legal representative
- **legalRepDocType**: legal representative document type
- **legalRepDocNumber**: legal representative document number
- **legalRepNationality**: legal representative nationality (ISO country code)
- **legalRepGender**: legal representative gender
- **legalRepDomicile**: legal representative address
- **bankName**: supplier bank name where payments are made
- **accountType**: supplier bank account type (Ahorros, Corriente)
- **accountNumber**: supplier bank account number
- **supervisor**: name of the contract supervisor or interventor
- **supervisorDocType**: supervisor document type
- **supervisorDocNumber**: supervisor document number
- **spendingAuthority**: name of the spending authority (ordenador del gasto)
- **spendingAuthorityDocNumber**: spending authority document number
- **paymentAuthority**: name of the payment authority (ordenador de pago)
- **paymentAuthorityDocNumber**: payment authority document number
- **resourceOrigin**: origin of the funding resources
- **purchaseProcess**: SECOP purchase-process identifier
- **signedDate**: date the contract was signed
- **startDate**: date the contract starts
- **endDate**: date the contract ends
- **url**: link to the public SECOP process page for the contract
- **observedAt**: when this contract was last seen by the scraper
### Who is it for
| Use case | Who benefits |
|---|---|
| Finding suppliers that win government contracts | Sales and lead-generation teams |
| KYC and counterparty checks before contracting | Compliance and risk teams |
| Tracking a competitor's public-sector wins | Market intelligence and strategy |
| Monitoring a public entity's spending and awards | Journalists, NGOs and watchdogs |
| Sizing the public market for a product or service | Business development and research |
### Frequently Asked Questions
**Which contracts does this cover?**
It covers electronic contracts published on SECOP II, Colombia's official public-procurement platform, across every department from Bogotá to Amazonas. You can filter by contracting entity, supplier, department, contract type, status, signing date and minimum value.
**Can I pull every contract for one supplier?**
Yes. Set the supplier NIT or document number and the scraper returns that supplier's full contract history across all government entities, which is ideal for KYC and competitor intelligence. You can also search by supplier name when you do not have the document number.
**How do I find all contracts from a specific government entity?**
Filter by the entity NIT to get every contract that entity has signed, or use the entity name for a broader text match. Combine it with a date range or minimum value to focus on recent or high-value awards.
**Does it include payment and supplier banking details?**
Yes, when the entity has published them. Records carry amounts paid, invoiced and pending, the supplier bank name and account, the legal representative document number and nationality, and the supervisor and spending authority. These fields populate on contracts that are already in execution or payment; very recently signed contracts may leave them empty.
**Do I need an API key or token?**
No. The datos.gov.co open-data API is public and needs no key. You can optionally supply a free Socrata application token to raise the rate limit on very large runs, but it is not required.
**Do I need a proxy to run this?**
No. The open-data portal is globally accessible and responds from standard datacenter connections, so runs work out of the box. An optional proxy setting is available only if you ever hit rate limits.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [SUNAT Peru RUC Scraper](https://apify.com/scrapers_lat/sunat-scraper): Extract Peru SUNAT taxpayer records by RUC or company name: legal name, status, tax address, CIIU...
- [Chile Mercado Publico Supplier & Award Scraper](https://apify.com/scrapers_lat/mercado-publico-scraper): Extract Chile state suppliers from Mercado Publico and ChileProveedores with public-procurement...
- [BCRA Argentina Debtor & Credit Risk Scraper](https://apify.com/scrapers_lat/bcra-deudores-scraper): Extract Argentina BCRA Central de Deudores credit-risk records by CUIT or CUIL: debtor name...
- [DataJud Brazil Court Case Scraper](https://apify.com/scrapers_lat/datajud-scraper): Extract Brazilian court process records from the CNJ DataJud public database across 90+ federal...
- [SAT Mexico 69-B Taxpayer Blacklist Scraper](https://apify.com/scrapers_lat/sat-69b-scraper): Extract Mexico SAT Lista 69-B (EFOS) blacklist of taxpayers presumed or confirmed to issue fake...
- [SCE/SEACE Peru Procurement Scraper](https://apify.com/scrapers_lat/seace-scraper): Extract Peru SEACE public procurement future-contracting announcements: entity, dates, type, object...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Colombia Compra Eficiente, SECOP or the datos.gov.co portal. It only accesses data that is publicly available as open data. Use it in accordance with the portal's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of contract records to collect across all matching filters. Optional.
## `entityName` (type: `string`):
Filter by the contracting government entity name (full-text match), for example 'ECOPETROL' or 'SERVICIO GEOLOGICO COLOMBIANO'. Matches contracts whose buyer entity name contains this text.
## `entityNit` (type: `string`):
Filter by the contracting entity tax-ID (NIT), digits only, for example '899999294'. Returns every contract signed by that public entity.
## `supplierName` (type: `string`):
Filter by the awarded supplier or contractor name (full-text match), for example a company or natural-person name. Useful for tracking a contractor across all its government contracts.
## `supplierNit` (type: `string`):
Filter by the awarded supplier document number (NIT for companies or cédula for individuals), digits only, for example '899999068'. Returns the full contract history for that supplier.
## `department` (type: `string`):
Filter by the Colombian department where the contract is executed.
## `contractType` (type: `string`):
Filter by the type of contract.
## `status` (type: `string`):
Filter by the current status of the contract.
## `dateFrom` (type: `string`):
Only include contracts signed on or after this date. Format YYYY-MM-DD, for example '2024-01-01'.
## `dateTo` (type: `string`):
Only include contracts signed on or before this date. Format YYYY-MM-DD, for example '2024-12-31'.
## `minValue` (type: `integer`):
Only include contracts whose value is greater than or equal to this amount, in Colombian pesos (COP). Optional.
## `freeText` (type: `string`):
Full-text search across all contract fields (entity, supplier, contract object, references). Use this for keyword searches such as a product, service or project name when you do not have a specific entity or supplier.
## `appToken` (type: `string`):
Optional Socrata application token for datos.gov.co. Not required, but providing one raises the API rate limit on large runs. Get a free token at evergreen.data.socrata.com.
## `proxyConfiguration` (type: `object`):
Optional Apify proxy configuration. The datos.gov.co open-data API is globally accessible and normally needs no proxy; enable this only if you hit rate limits.
## Actor input object example
```json
{
"maxItems": 10,
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/colombia-secop-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "maxItems": 10 }
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/colombia-secop-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10
}' |
apify call scrapers_lat/colombia-secop-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/colombia-secop-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Colombia SECOP Scraper",
"description": "Extract Colombia public contracts from SECOP II (datos.gov.co): entity and supplier, NIT, contract value, amounts paid and invoiced, legal representative ID, supplier bank and account, UNSPSC category, supervisor and spending authority.",
"version": "0.1",
"x-build-id": "0sMLkjb2Z3XF1XhkN"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~colombia-secop-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-colombia-secop-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/scrapers_lat~colombia-secop-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-colombia-secop-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/scrapers_lat~colombia-secop-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-colombia-secop-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": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of contract records to collect across all matching filters. Optional."
},
"entityName": {
"title": "Entity Name",
"type": "string",
"description": "Filter by the contracting government entity name (full-text match), for example 'ECOPETROL' or 'SERVICIO GEOLOGICO COLOMBIANO'. Matches contracts whose buyer entity name contains this text."
},
"entityNit": {
"title": "Entity NIT",
"type": "string",
"description": "Filter by the contracting entity tax-ID (NIT), digits only, for example '899999294'. Returns every contract signed by that public entity."
},
"supplierName": {
"title": "Supplier Name",
"type": "string",
"description": "Filter by the awarded supplier or contractor name (full-text match), for example a company or natural-person name. Useful for tracking a contractor across all its government contracts."
},
"supplierNit": {
"title": "Supplier NIT / Document",
"type": "string",
"description": "Filter by the awarded supplier document number (NIT for companies or cédula for individuals), digits only, for example '899999068'. Returns the full contract history for that supplier."
},
"department": {
"title": "Department",
"enum": [
"Amazonas",
"Antioquia",
"Arauca",
"Atlántico",
"Bolívar",
"Boyacá",
"Caldas",
"Caquetá",
"Casanare",
"Cauca",
"Cesar",
"Chocó",
"Cundinamarca",
"Córdoba",
"Distrito Capital de Bogotá",
"Guainía",
"Guaviare",
"Huila",
"La Guajira",
"Magdalena",
"Meta",
"Nariño",
"Norte de Santander",
"Putumayo",
"Quindío",
"Risaralda",
"San Andrés, Providencia y Santa Catalina",
"Santander",
"Sucre",
"Tolima",
"Valle del Cauca",
"Vaupés",
"Vichada"
],
"type": "string",
"description": "Filter by the Colombian department where the contract is executed."
},
"contractType": {
"title": "Contract Type",
"enum": [
"Acuerdo Marco de Precios",
"Acuerdo de cooperación",
"Arrendamiento de inmuebles",
"Arrendamiento de muebles",
"Asociación Público Privada",
"Comisión",
"Comodato",
"Compraventa",
"Concesión",
"Consultoría",
"Decreto 092 de 2017",
"Interventoría",
"Negocio fiduciario",
"Obra",
"Operaciones de Crédito Público",
"Otro",
"Prestación de servicios",
"Seguros",
"Servicios financieros",
"Suministros",
"Venta inmuebles",
"Venta muebles"
],
"type": "string",
"description": "Filter by the type of contract."
},
"status": {
"title": "Contract Status",
"enum": [
"Aprobado",
"Borrador",
"Cancelado",
"Cerrado",
"En aprobación",
"En ejecución",
"Modificado",
"Prorrogado",
"Suspendido",
"cedido",
"enviado Proveedor",
"terminado"
],
"type": "string",
"description": "Filter by the current status of the contract."
},
"dateFrom": {
"title": "Signed From (YYYY-MM-DD)",
"type": "string",
"description": "Only include contracts signed on or after this date. Format YYYY-MM-DD, for example '2024-01-01'."
},
"dateTo": {
"title": "Signed To (YYYY-MM-DD)",
"type": "string",
"description": "Only include contracts signed on or before this date. Format YYYY-MM-DD, for example '2024-12-31'."
},
"minValue": {
"title": "Minimum Contract Value (COP)",
"minimum": 0,
"type": "integer",
"description": "Only include contracts whose value is greater than or equal to this amount, in Colombian pesos (COP). Optional."
},
"freeText": {
"title": "Free-text Search",
"type": "string",
"description": "Full-text search across all contract fields (entity, supplier, contract object, references). Use this for keyword searches such as a product, service or project name when you do not have a specific entity or supplier."
},
"appToken": {
"title": "Socrata App Token",
"type": "string",
"description": "Optional Socrata application token for datos.gov.co. Not required, but providing one raises the API rate limit on large runs. Get a free token at evergreen.data.socrata.com."
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Optional Apify proxy configuration. The datos.gov.co open-data API is globally accessible and normally needs no proxy; enable this only if you hit rate limits.",
"default": {
"useApifyProxy": 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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```