Ler mais

Tendersight API

Dados de concursos para os seus sistemase para os seus agentes.

Pesquise anúncios e leia os respetivos documentos, propostas e compradores a partir do seu próprio software, através de uma única API. As chamadas usam os mesmos créditos que a aplicação.

Começar grátisLer a referência da API
Pedido de exemplo
curl https://api.tendersight.ai/v1/notices/search \
  -H "Authorization: Bearer $TENDERSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "searchText": "lift maintenance",
      "contractTypes": ["services"],
      "buyer": { "countries": ["AUT", "DEU"] },
      "deadline": { "from": "2026-11-16T00:00:00Z" },
      "estimatedValue": { "min": 250000 }
    },
    "pageSize": 20
  }'
Resposta de exemplo, abreviada
{
  "items": [
    {
      "key": "not_01kf3m8q2vx7d9hk4tz6rbn5cw",
      "title": "Maintenance of lifts in federal buildings, 3 lots",
      "publicationDate": "2026-11-03T08:00:00+00:00",
      "estimatedValue": {
        "minAmount": null,
        "maxAmount": 1800000,
        "currency": "EUR",
        "minAmountEur": null,
        "maxAmountEur": 1800000
      },
      "buyers": [
        {
          "organizationKey": "org_01jz8r5t2kw4n6p9c3x7v1hmqd",
          "name": "Federal property agency",
          "country": "AUT",
          "fiscalId": "ATU12345678"
        }
      ],
      "milestones": [
        {
          "type": "deadline",
          "name": "Time limit for receipt of tenders",
          "date": "2026-12-01T10:00:00+00:00"
        }
      ],
      "contractType": "services",
      "primaryCpv": {
        "code": "50750000-7",
        "description": "Lift-maintenance services"
      },
      "biddability": "biddable",
      "nextDeadlineAt": "2026-12-01T10:00:00+00:00"
    }
  ],
  "continuationToken": "eyJhZnRlciI6WzEuOTQs…",
  "totalCount": 23
}

Anúncios de 28+ fontes oficiais

REST e MCP com uma só chave

Créditos por chamada, em todos os planos

Os anúncios que a sua equipa lê no Tendersight, entregues no seu CRM, no seu armazém de dados ou no seu próprio agente.

A API lê o mesmo índice que o Tendersight Leads. Use-a para alimentar um pipeline comercial, enriquecer registos de compradores e fornecedores ou dar a um agente a sua própria pesquisa de concursos.

O que a API devolve.

Seis tipos de dados, em 9 endpoints.

  • Pesquisa de anúncios

    Filtre por texto, código CPV, país e região do comprador, valor estimado em euros, prazo, data de publicação e tipo de anúncio.

  • Detalhes do anúncio

    Um anúncio pela sua chave, com os compradores, o valor estimado, os prazos, os critérios de adjudicação, o código CPV e o estado do procedimento.

  • Documentos do concurso

    A lista dos documentos de um anúncio e cada ficheiro, descarregado através da API.

  • Propostas e vencedores

    Quem apresentou proposta a um anúncio, o valor de cada proposta e quem ganhou, quando a fonte os publica.

  • Compradores e fornecedores

    Pesquise os compradores que publicaram anúncios por qualquer parte do nome ou pelo número de identificação fiscal. Qualquer comprador ou fornecedor encontra-se pelo número de identificação fiscal ou pela chave.

  • Metadados dos filtros

    Os valores de filtro que a pesquisa aceita e quantos anúncios tem cada um. Esta chamada não usa créditos.

Do registo à sua primeira chamada.

Uma conta, uma chave e um cabeçalho. A referência da API lista todos os endpoints, campos e erros.

  1. 01

    Crie uma conta gratuita

    Registe-se gratuitamente. Todos os planos incluem a API, e as chamadas usam os mesmos créditos que o resto do Tendersight.

  2. 02

    Crie uma chave de API

    Um proprietário da equipa abre a gestão de chaves de API nas definições da equipa, dá um nome à chave e escolhe os seus âmbitos. A chave só é mostrada uma vez, por isso guarde-a em segurança.

  3. 03

    Faça a sua primeira chamada

    Envie a chave como token Bearer. Comece com uma pesquisa de anúncios e depois abra os anúncios, documentos e propostas que ela devolve.

Autenticação
Authorization: Bearer tsk_live_…

Envie a chave em cada chamada. A chave deixa de funcionar assim que é revogada.

Âmbitos
notices:readdocuments:readawards:readorganizations:read

Uma chave tem apenas os âmbitos que escolher. Uma chamada fora deles recebe um 403.

Paginação
continuationToken

Uma pesquisa devolve até 100 anúncios por página e um token para a página seguinte. Envie o token de volta para continuar.

Limites de pedidos
429Retry-After

Por omissão, 10 pedidos por segundo e 100 000 por dia, por chave. Acima do limite, a API responde 429 e indica quando tentar de novo.

Erros
application/problem+json

Detalhes do problema em JSON: 401 para uma chave em falta, desconhecida ou revogada, 402 quando os créditos da equipa não cobrem a chamada, 403 para um âmbito em falta, 429 para demasiados pedidos.

Créditos
X-Credits-ChargedX-RateLimit-Remaining

Cada resposta indica o que a chamada usou e quantos pedidos restam. Só as chamadas bem-sucedidas usam créditos.

Ler a referência da API Documento OpenAPI

Pague por chamada, em créditos.

As chamadas usam o saldo de créditos da sua equipa, o mesmo que o Flow usa na aplicação. No Team, 1000 créditos custam 2,50 €. Uma conta gratuita recebe 2000 créditos no registo.

Ver planos e preços
Créditos por chamada à Tendersight API
ChamadaCréditos por chamada
Uma pesquisa de anúncios POST /v1/notices/search2
Um anúncio GET /v1/notices/{noticeKey}1
A lista de documentos de um anúncio GET /v1/notices/{noticeKey}/documents1
Um documento descarregado GET /v1/notices/{noticeKey}/documents/{documentId}5
As propostas de um anúncio GET /v1/notices/{noticeKey}/bids5
Uma pesquisa de compradores GET /v1/buyers?query=&limit=1
Uma pesquisa de compradores ou fornecedores pelo número de identificação fiscal GET /v1/organizations?fiscalId=&limit=1
Um comprador ou fornecedor GET /v1/organizations/{organizationKey}1
Os valores de filtro da pesquisa GET /v1/meta/filters0

Só as chamadas bem-sucedidas usam créditos.

Os mesmos dados para os seus agentes, através de MCP.

Ligue qualquer cliente MCP ao servidor Tendersight com a mesma chave. As ferramentas seguem os endpoints REST e usam os mesmos âmbitos e créditos.

Configuração de cliente de exemplo
{
  "mcpServers": {
    "tendersight": {
      "url": "https://api.tendersight.ai/mcp",
      "headers": {
        "Authorization": "Bearer tsk_live_…"
      }
    }
  }
}
  • search_noticesPesquisa anúncios com os mesmos filtros que a API
  • get_noticeLê um anúncio
  • list_notice_documentsLista os documentos de um anúncio
  • list_notice_bidsLista as propostas de um anúncio
  • search_buyersEncontra compradores pelo nome ou número de identificação fiscal
  • get_organizationLê um comprador ou fornecedor
  • search_organizationsEncontra compradores e fornecedores pelo número de identificação fiscal

Relacionado

Dados de concursos

Ligações

Planos

Perguntas sobre a Tendersight API

Que concursos cobre a API?

Os mesmos anúncios que o Tendersight Leads: concursos públicos de 28+ fontes oficiais, com os respetivos documentos, os compradores e fornecedores envolvidos e, quando a fonte os publica, as propostas e os vencedores.

Quanto custa uma chamada?

Cada chamada bem-sucedida usa entre 0 e 5 créditos do saldo da sua equipa, consoante o endpoint. A tabela desta página lista todos os endpoints, e as chamadas falhadas não usam nenhum.

Posso experimentar a API gratuitamente?

Sim. A API está em todos os planos, incluindo o Grátis. Uma conta gratuita recebe 2000 créditos no registo, e as chamadas à API usam esses créditos como o resto do Tendersight.

Quais são os limites de pedidos?

Por omissão, 10 pedidos por segundo e 100 000 por dia, por chave. Acima do limite, a API responde 429 com um cabeçalho Retry-After, e as respostas incluem X-RateLimit-Limit e X-RateLimit-Remaining.

Quão atuais são os dados?

Cada chamada lê o mesmo índice que a aplicação Tendersight pesquisa, e esse índice é atualizado diariamente a partir das fontes oficiais.

Quem pode criar e revogar chaves de API?

Os proprietários da equipa, nas definições da equipa. Cada chave tem um nome e os seus próprios âmbitos, é mostrada uma vez quando é criada e deixa de funcionar assim que é revogada.

Crie uma chave e faça a sua primeira chamada.

Comece grátis, crie uma chave de API nas definições da equipa e siga a referência da API.

Começar grátis Ler a referência da API