Для розробників

Дані для ваших ідей.

Створюйте корисні інструменти з відкритим API або підключайте помічника ШІ через MCP.

США та КанадаЛише публічні даніБез ключа API

Підключіть свого помічника ШІ

MCP · Streamable HTTP

Додайте цю адресу як віддалений MCP-сервер у сумісному помічнику. Вхід, токен і ключ API не потрібні.

https://stage1-preview.ukramerica.com/mcp

Для клієнтів із конфігурацією mcpServers:

{
  "mcpServers": {
    "ukramerica": {
      "url": "https://stage1-preview.ukramerica.com/mcp"
    }
  }
}

Спробуйте запит

Знайди українські ресторани та церкви у Chicago. Дай посилання на оголошення та їхні офіційні джерела.

Інструменти: list_cities, list_categories, search_listings, get_listing. Ресурси: міста, категорії, довідник та OpenAPI. Усі операції лише для читання.

Почніть з одного запиту

OpenAPI 3.2.1

Знайдіть місто та категорію, а потім отримайте потрібні оголошення. Кожне місто й оголошення містить посилання на українську та англійську сторінки.

curl 'https://stage1-preview.ukramerica.com/api/v1/ads?city=chicago&category=restaurants&pageSize=12'

Міста Канади/api/v1/cities?country=CAКатегорії оголошень/api/v1/categoriesРесторани у Chicago/api/v1/ads?city=chicago&category=restaurants&pageSize=12Майбутні події в Канаді/api/v1/ads?country=CA&kind=event&upcoming=true

Приклад JavaScript

const response = await fetch(
  'https://stage1-preview.ukramerica.com/api/v1/ads?city=toronto&pageSize=24'
);
if (!response.ok) throw new Error('Request failed');
const { items, links } = await response.json();
// Follow links.next until it is null.
console.log(items.map(item => item.urls.en));

Що можна отримати

Адреса	Результат
`GET /api/v1/cities`	Доступні міста, ключі, країни й часові пояси. Фільтри: country, q.
`GET /api/v1/categories`	Категорії обома мовами. Фільтр: kind.
`GET /api/v1/ads`	Пошук, фільтри та сторінки опублікованих оголошень.
`GET /api/v1/ads/{id}`	Одне оголошення за UUID.

Фільтри пошуку: q, city, country, category, kind, section, currency, min, max, sort, page, pageSize, upcoming. Повна схема й можливі значення є в OpenAPI.

Як працювати з даними

API повертає лише опубліковані оголошення. Чернетки, облікові записи та адміністративні дані недоступні.
Назви міст залишаються англійською. Тексти оголошень містять доступні переклади.
Суми в результатах — у мінімальних одиницях USD або CAD (1250 = 12.50). Фільтри min/max приймають звичайні суми; вкажіть currency.
За замовчуванням 24 оголошення на сторінку, максимум 48. Дотримуйтеся links.next; ліміт сторінок — 1000.
Спільний ліміт на процес: 600 запитів за хвилину, 8 одночасно. У разі 429 зачекайте згідно з Retry-After. Зберігайте результати локально та не запускайте необмежені цикли.
Повертайтеся до сторінки оголошення та офіційних джерел, щоб перевірити актуальність. Схвалення не є гарантією якості; API не надає прав на повторну публікацію чужих матеріалів.

Приватність · Правила спільноти