Прочети повече

Tendersight API

Данни за поръчки за вашите системии за вашите агенти.

Търсете обявления и четете техните документи, оферти и възложители от собствения си софтуер, чрез едно API. Извикванията използват същите кредити като приложението.

Примерна заявка
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
  }'
Примерен отговор, съкратен
{
  "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
}

Обявления от 28+ официални източника

REST и MCP с един ключ

Кредити за извикване, във всеки план

Обявленията, които екипът ви чете в Tendersight, доставени във вашата CRM система, хранилище за данни или собствен агент.

API чете същия индекс като Tendersight Leads. Използвайте го, за да захранвате търговски pipeline, да обогатявате записите за възложители и доставчици или да дадете на агент собствено търсене на поръчки.

Какво връща API.

Шест вида данни в 9 крайни точки.

  • Търсене на обявления

    Филтрирайте по текст, CPV код, държава и регион на възложителя, прогнозна стойност в евро, срок, дата на публикуване и вид обявление.

  • Подробности за обявлението

    Едно обявление по неговия ключ, с възложителите, прогнозната стойност, сроковете, критериите за възлагане, CPV кода и статуса на процедурата.

  • Документация за поръчката

    Списъкът с документите на обявлението и всеки файл, изтеглен чрез API.

  • Оферти и победители

    Кой е подал оферта по обявлението, стойността на всяка оферта и кой е спечелил, когато източникът ги публикува.

  • Възложители и доставчици

    Търсете възложителите, публикували обявления, по произволна част от името или по данъчен идентификационен номер. Всеки възложител или доставчик се намира по данъчния си идентификационен номер или ключ.

  • Метаданни за филтрите

    Стойностите на филтрите, които търсенето приема, и колко обявления съдържа всяка от тях. Това извикване не използва кредити.

От регистрацията до първото ви извикване.

Акаунт, ключ и една заглавка. Справочникът за API описва всяка крайна точка, поле и грешка.

  1. 01

    Създайте безплатен акаунт

    Регистрирайте се безплатно. Всеки план включва API, а извикванията използват същите кредити като останалата част от Tendersight.

  2. 02

    Създайте API ключ

    Собственик на екипа отваря управлението на API ключовете в настройките на екипа, дава име на ключа и избира обхватите му. Ключът се показва само веднъж, затова го съхранете на сигурно място.

  3. 03

    Направете първото си извикване

    Изпращайте ключа като Bearer токен. Започнете с търсене на обявления, след това отворете обявленията, документите и офертите, които то връща.

Удостоверяване
Authorization: Bearer tsk_live_…

Изпращайте ключа с всяко извикване. Той спира да работи веднага щом бъде отменен.

Обхвати
notices:readdocuments:readawards:readorganizations:read

Ключът има само обхватите, които изберете. Извикване извън тях получава 403.

Странициране
continuationToken

Търсенето връща до 100 обявления на страница и токен за следващата. Изпратете токена обратно, за да продължите.

Ограничения на заявките
429Retry-After

По подразбиране 10 заявки в секунда и 100 000 на ден за всеки ключ. Над лимита API отговаря с 429 и посочва кога да опитате отново.

Грешки
application/problem+json

Подробности за проблема в JSON: 401 при липсващ, непознат или отменен ключ, 402, когато кредитите на екипа не покриват извикването, 403 при липсващ обхват, 429 при твърде много заявки.

Кредити
X-Credits-ChargedX-RateLimit-Remaining

Всеки отговор показва колко е използвало извикването и колко заявки остават. Само успешните извиквания използват кредити.

Плащате за извикване, с кредити.

Извикванията черпят от кредитния баланс на екипа ви, същия, който Flow използва в приложението. В Team 1000 кредита струват 2,50 €. Безплатният акаунт получава 2000 кредита при регистрация.

Вижте плановете и цените
Кредити за извикване на Tendersight API
ИзвикванеКредити за извикване
Търсене на обявления POST /v1/notices/search2
Едно обявление GET /v1/notices/{noticeKey}1
Списък с документите на обявление GET /v1/notices/{noticeKey}/documents1
Изтегляне на документ GET /v1/notices/{noticeKey}/documents/{documentId}5
Офертите по обявление GET /v1/notices/{noticeKey}/bids5
Търсене на възложители GET /v1/buyers?query=&limit=1
Търсене на възложители или доставчици по данъчен идентификационен номер GET /v1/organizations?fiscalId=&limit=1
Един възложител или доставчик GET /v1/organizations/{organizationKey}1
Стойностите на филтрите за търсене GET /v1/meta/filters0

Само успешните извиквания използват кредити.

Същите данни за вашите агенти, чрез MCP.

Свържете всеки MCP клиент със сървъра на Tendersight със същия ключ. Инструментите следват крайните точки на REST и използват същите обхвати и кредити.

Примерна конфигурация на клиент
{
  "mcpServers": {
    "tendersight": {
      "url": "https://api.tendersight.ai/mcp",
      "headers": {
        "Authorization": "Bearer tsk_live_…"
      }
    }
  }
}
  • search_noticesТърси обявления със същите филтри като API
  • get_noticeЧете едно обявление
  • list_notice_documentsИзброява документите на обявление
  • list_notice_bidsИзброява офертите по обявление
  • search_buyersНамира възложители по име или данъчен идентификационен номер
  • get_organizationЧете един възложител или доставчик
  • search_organizationsНамира възложители и доставчици по данъчен идентификационен номер

Въпроси за Tendersight API

Кои поръчки обхваща API?

Същите обявления като в Tendersight Leads: обществени поръчки от 28+ официални източника, с документите им, участващите възложители и доставчици и, когато източникът ги публикува, офертите и победителите.

Колко струва едно извикване?

Всяко успешно извикване използва между 0 и 5 кредита от баланса на екипа ви, в зависимост от крайната точка. Таблицата на тази страница изброява всички крайни точки, а неуспешните извиквания не използват кредити.

Мога ли да изпробвам API безплатно?

Да. Всеки план включва API, включително Безплатен. Безплатният акаунт получава 2000 кредита при регистрация, а извикванията на API черпят от тях като останалата част от Tendersight.

Какви са ограниченията на заявките?

По подразбиране 10 заявки в секунда и 100 000 на ден за всеки ключ. Над лимита API отговаря с 429 и заглавка Retry-After, а отговорите съдържат X-RateLimit-Limit и X-RateLimit-Remaining.

Колко актуални са данните?

Всяко извикване чете същия индекс, в който търси приложението Tendersight, а този индекс се обновява ежедневно от официалните източници.

Кой може да създава и отменя API ключове?

Собствениците на екипа, в настройките на екипа. Всеки ключ има име и собствени обхвати, показва се веднъж при създаването си и спира да работи веднага щом бъде отменен.

Създайте ключ и направете първото си извикване.

Започнете безплатно, създайте API ключ в настройките на екипа и следвайте справочника за API.