SECOP II Colombia Tenders Scraper

Find Colombian public tenders on SECOP II, the national e-procurement system run by Colombia Compra Eficiente, and get one clean row per tender: title, buying entity and its tax id, department and city, procurement method, contract type, status, UNSPSC category codes, estimated value in pesos, publication date, deadline for offers, days left and the link to the official notice. Turn on details to add the tender documents (specifications, studies, annexes) with download links and a description excerpt.

By default you get only tenders that are still open: published on SECOP II, with offers accepted until today or later. Drafts that are not public yet are left out. Schedule a daily run with "published or changed since 2 days" and your keywords, buyer or department to get alerts for new tenders in email, Slack or a spreadsheet.

For contracts that have already been awarded and the companies that won them, see our Colombia SECOP Contracts + Supplier Company Profiles actor.

Quick start

Open tenders, newest first:

{"maxItems": 20}

Open security-services tenders in Antioquia, closing soonest first:

{"keywords": ["vigilancia"], "department": "Antioquia", "sort": "deadlineSoonest"}

New construction tenders above 1,000 million pesos, with documents:

{"categoryCodes": ["72"], "minEstimatedValue": 1000000000, "publishedSince": "2 days", "includeDetails": true}

Input

Field	Type	Default	What it does
keywords	list	[]	Words searched in the tender title, description and buyer, accents optional (energia finds energía). Several keywords return tenders that match any of them.
status	string	open	open (published, deadline for offers today or later), closed, awarded, cancelled or all.
publishedSince	date	none	Only tenders published or updated on or after this date, e.g. 2026-11-01, or within a period such as 2 days.
buyer	string	""	Buying entity: part of its name, case and accents ignored (policia), or its tax id (NIT, digits only).
department	string	""	Department of the buyer, e.g. Antioquia, Valle del Cauca, Bogotá. Accents optional.
city	string	""	City of the buyer, the whole name, e.g. Medellín or Pasto. Accents optional.
procurementMethods	list	all competitive	Public tender, abbreviated selection, reverse auction, merit contest, minimum value, special regime with offers, direct contracting with offers, request for information or sale of state assets. Direct contracting and special-regime awards without competition are only included when you select them.
categoryCodes	list	[]	UNSPSC code prefixes, 2 to 8 digits, e.g. 72 (building and construction) or 81112000.
minEstimatedValue	integer	none	Only tenders with a published estimated value of at least this many pesos.
sort	string	newest	newest or deadlineSoonest.
maxItems	integer	50	Maximum tenders returned, up to 10,000.
includeDetails	boolean	false	Add the tender documents and a description excerpt.

What it returns

Every row has tenderId, reference, noticeId, portfolioId, title, buyer (name, taxId, entityCode, level, unit), country, region, city, procurementMethod, contractType, status (open, closed, awarded or cancelled), sourceStatus, phase, categoryScheme, categoryCodes, estimatedValue, awardedValue, currency, publishedDate, lastPublishedDate, deadlineDate, daysUntilDeadline, offersOpeningDate, datesTimezone, duration, durationUnit, lots, url, source and scrapedAt.

With includeDetails on, rows also fill descriptionExcerpt (up to 600 characters) and documents (each with documentId, name, fileType, sizeBytes and url). If documents cannot be read for a row, the row is still delivered and detailsError says why.

Dates are calendar dates in Bogotá (YYYY-MM-DD, UTC-5): SECOP II publishes the day of the deadline, not the hour, so check the official notice for the closing time. daysUntilDeadline is 0 when offers close today. Values are numbers in Colombian pesos (COP).

What can be empty, and why

• estimatedValue is empty when the buyer did not publish a budget, for example on requests for information.
• categoryCodes is empty when the buyer did not classify the tender; many open tenders carry no code, so a category filter returns fewer tenders than a keyword search.
• city and region are empty when SECOP II does not say where the buyer is.
• publishedDate is empty for a small share of tenders that SECOP II lists without one.
• title is empty when the source has no title.
• documents is empty for tenders whose files SECOP II has not listed yet; newly published tenders can take a day or two.

Limits

• The official open-data copy of SECOP II is updated daily and usually runs one or two days behind the portal. A tender published this morning may appear tomorrow.
• Runs are quick: 500 tenders took about 3 seconds in our tests, and 300 tenders with documents about 15 seconds.
• Up to 10,000 tenders per run. For more, split the search by department, method or date.

Published information

Titles, references, descriptions and document names retain the public text published by the buyer, including contact information where present.

FAQ

How do I get only new tenders each day? Schedule a daily run with publishedSince: "2 days" and your filters, and deduplicate on tenderId. Each run is independent, so overlapping windows deliver (and charge for) the same tenders again.

What happens when nothing matches? The run succeeds with an empty dataset and a status message saying no tenders matched.

Pricing

See the Pricing tab for the current price. The start charge is per GB of memory, rounded up; the default 512 MB run is one start.

Output example

{"tenderId": "CO1.REQ.11296787", "reference": "MC-RDC-CGA-009-2026", "noticeId": "CO1.NTC.11160203", "portfolioId": "CO1.BDOS.11107663", "title": "Contratar la compra de insumos de tóner originales; necesarios para el adecuado funcionamiento de las dependencias del Centro de Gestión Administrativa.", "buyer": {"name": "SENA-GRUPO DE APOYO ADMINITRATIVO INTERCENTROS CGA Y CFAFC", "taxId": "899999034", "entityCode": "724589023", "level": "Nacional", "unit": "CENTRO DE GESTIÓN ADMINISTRATIVA"}, "country": "CO", "region": "Distrito Capital de Bogotá", "city": "Bogotá", "procurementMethod": "Mínima cuantía", "contractType": "Suministros", "status": "open", "sourceStatus": "Aprobado", "phase": "Presentación de oferta", "categoryScheme": null, "categoryCodes": [], "estimatedValue": 8487000.0, "awardedValue": null, "currency": "COP", "publishedDate": "2026-11-01", "lastPublishedDate": "2026-11-01", "deadlineDate": "2026-11-09", "daysUntilDeadline": 6, "offersOpeningDate": "2026-11-09", "datesTimezone": "America/Bogota", "duration": 30, "durationUnit": "days", "lots": null, "url": "https://community.secop.gov.co/Public/Tendering/OpportunityDetail/Index?noticeUID=CO1.NTC.11160203", "descriptionExcerpt": "Contratar la compra de insumos de tóner originales, necesarios para el adecuado funcionamiento de las dependencias del Centro de Gestión Administrativa.", "documents": [{"documentId": "884186459", "name": "1. DESIGNACION COMUNICACION FUNCIONARIOS Y CONTRATISTAS TONNER (1) (1).pdf", "fileType": "pdf", "sizeBytes": 179651, "url": "https://community.secop.gov.co/Public/Archive/RetrieveFile/Index?DocumentId=884186459&InCommunity=False&InPaymentGateway=False&DocUniqueIdentifier="}, {"documentId": "884186460", "name": "2. SOLCIITUD INICIO PROCESO CONTRATCTUAL.pdf", "fileType": "pdf", "sizeBytes": 190189, "url": "https://community.secop.gov.co/Public/Archive/RetrieveFile/Index?DocumentId=884186460&InCommunity=False&InPaymentGateway=False&DocUniqueIdentifier="}], "detailsError": null, "source": "SECOP II (Colombia Compra Eficiente)", "scrapedAt": "2026-11-03T17:13:59.812155+00:00"}

Support

For questions or issues, contact us from the Actor page.