O SAM.gov é onde as agências federais dos Estados Unidos publicam suas oportunidades de contratação: toda ação contratual prevista acima de 25.000 dólares, do aviso de pesquisa de fontes à solicitação de propostas e à adjudicação. A partir de hoje, POST /us/sam/opportunities-search/v1 busca entre todos os avisos que o SAM.gov mantém ativos, cerca de 75.000, e POST /us/sam/opportunity/v1 retorna um deles inteiro. Os dois respondem a partir da cópia da Croma, atualizada todos os dias.
curl https://api.croma.run/us/sam/opportunities-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "cybersecurity",
"type": "sources_sought",
"deadline_from": "2026-10-09"
}'type escolhe o tipo de aviso e deadline_from mantém só os que ainda aceitam respostas. Os demais filtros:
| Filtro | O que restringe |
|---|---|
query | Palavras do título, do texto, do adjudicatário ou do número de solicitação, com stemming em inglês |
type | solicitation, combined_synopsis_solicitation, presolicitation, sources_sought, special_notice, award_notice e mais cinco |
department, sub_tier | O departamento e a agência que publicam, como o SAM.gov escreve: DEPT OF DEFENSE, DEPT OF THE ARMY |
naics_code, classification_code | Os códigos NAICS e PSC, como prefixos: 23 é toda a construção, D todos os serviços de TI |
set_aside | SBA (pequenas empresas), SDVOSBC, WOSB, 8A, HZC ou NONE |
performance_state, office_state | Onde o trabalho é executado e onde fica o escritório contratante |
from_date, to_date, deadline_from, deadline_to | A data de publicação e o prazo de resposta |
sort | recent, deadline (o prazo mais próximo primeiro) ou amount_desc (a maior adjudicação primeiro) |
Cada aviso traz seu título e seu texto, o número de solicitação, o departamento, a agência e o escritório que o publicou, os códigos NAICS e PSC, o set-aside, o prazo de resposta, o local de execução, o contato do oficial de contratação e, para uma adjudicação, o contratado, o valor e a data.
Também as adjudicações#
Cerca de 14.000 dos avisos ativos são adjudicações, então a mesma busca responde quem ganhou o quê: type: "award_notice" com sort: "amount_desc" lista as maiores adjudicações recentes de uma agência, e query encontra um contratado pelo nome.
Como consultar#
Os dois são endpoints de dataset: respondem em milissegundos e trazem as_of, o quão atual é a cópia. Um aviso que o SAM.gov arquiva sai da lista na atualização seguinte, e pedi-lo depois retorna found: false, que é uma resposta completa, não um erro. Também estão no servidor MCP como sam_opportunities_search e sam_opportunity, e um monitor sobre uma busca envia por e-mail o que há de novo após cada atualização diária.
O guia completo está em Oportunidades de contratação do SAM.gov. As partes impedidas de contratar com o governo federal são outra fonte, Exclusões do SAM.gov. As demais fontes dos Estados Unidos estão em Estados Unidos.