REST API · v1
Інтегруйте дані про вантажі зі США, Великої Британії та Європи безпосередньо у вашу TMS, ERP або власний застосунок. Отримуйте актуальні вантажі, фільтруйте їх за країною й типом транспорту та автоматизуйте ваші вантажні операції.
Ця сторінка описує ендпоінт маркетплейсу: він повертає актуальні реальні вантажі на ринках, до яких має доступ ваш обліковий запис, із фільтрами та пагінацією. Щоб розміщувати вантажі вашої компанії та керувати ними, див. посібник для розробників (API компанії). Типові сценарії:
Інтеграція з TMS
Завантажуйте поточні вантажі з ваших ринків у вашу систему управління перевезеннями (TMS).
Автоматизація
Регулярно перевіряйте наявність нових вантажів, що відповідають вашим фільтрам.
Власні дашборди
Показуйте вантажі GigFreight у ваших власних інструментах.
Що не повертається
Прострочені вантажі та будь-які контактні дані ніколи не повертаються.
Кожен запит до API має містити ваш API-ключ у заголовку Authorization як Bearer-токен. Доступ до API входить до тарифу Elite: користувачі з підпискою Elite можуть створити до 5 ключів у розділіНалаштування → API-ключі. Ключі перестають працювати, поки в обліковому записі немає активного тарифу Elite.
Зберігайте API-ключ у таємниці. Ніколи не розкривайте його в клієнтському JavaScript, Git-репозиторіях чи публічних URL-адресах. Якщо ключ було розкрито, відкличте його в особистому кабінеті та створіть новий.
GET /api/v1/marketplace/loads HTTP/1.1
Host: gigfreight.com
Authorization: Bearer gf_your_api_key_here
Accept: application/jsonhttps://gigfreight.com/api/v1Усі ендпоінти вказано відносно цієї базової URL-адреси. Використовуйте HTTPS.
/api/v1/marketplace/loadsПовертає список актуальних вантажів із пагінацією (статус available або interested, дата завантаження – сьогодні або пізніше) на ринках вашого облікового запису: облікові записи ЄС і Великої Британії бачать ЄС + Велику Британію, облікові записи TR – ЄС + Велику Британію + TR, облікові записи US – US. Вантажі з видимістю Elite включаються лише для тарифів Elite. Адреси, примітки та контактні дані ніколи не повертаються.
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
origin_country | string | Ні | Країна відправлення так, як вона вказана у вантажі (напр., Germany); точний збіг без урахування регістру |
destination_country | string | Ні | Країна призначення, той самий формат |
vehicle_type | string | Ні | Ідентифікатор типу транспорту, напр., curtainsider, dry_van, reefer, flatbed |
region | string | Ні | Один із ваших ринків: eu, uk, tr або us |
page | integer | Ні | Номер сторінки, за замовчуванням 1 |
limit | integer | Ні | Кількість елементів на сторінці, за замовчуванням 20, максимум 100 |
{
"data": [
{
"id": "uuid",
"status": "available",
"visibility": "standard",
"region": "eu",
"pickup_city": "Warsaw",
"origin_country": "Poland",
"pickup_date": "2026-07-15",
"delivery_city": "Berlin",
"destination_country": "Germany",
"delivery_date": "2026-07-16",
"vehicle_type": "curtainsider",
"weight_kg": 18000,
"distance_km": 575,
"rate": 1250.00,
"currency": "EUR",
"commodity": "Automotive parts",
"created_at": "2026-06-30T08:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 148,
"pages": 8
}
}| HTTP-статус | Значення |
|---|---|
200 OK | Запит виконано успішно. |
401 Unauthorized | API-ключ відсутній, недійсний або відкликаний. |
402 Payment Required | В обліковому записі немає активної оплаченої підписки. |
403 Forbidden | Тариф не включає доступ до API (лише Elite) або обліковий запис призупинено. |
429 Too Many Requests | Перевищено ліміт запитів. Повторіть спробу через кількість секунд, зазначену в заголовку Retry-After. |
500 Internal Server Error | Не вдалося виконати запит. Якщо помилка повторюється, напишіть на partners@gigfreight.com. |
503 Service Unavailable | API тимчасово недоступний. |
| Ліміт | Запитів / хвилину | Запитів / день |
|---|---|---|
| На один API-ключ | 60 | 10 000 |
| На одну IP-адресу клієнта | 120 | — |
Успішні та відхилені відповіді містять заголовки X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (час Unix) для вашого ключа; відповідь 429 також містить Retry-After.
Повне порівняння тарифів – на сторінці Ціни.
curl -X GET "https://gigfreight.com/api/v1/marketplace/loads?origin_country=PL&destination_country=DE&page=1" \
-H "Authorization: Bearer gf_your_api_key" \
-H "Accept: application/json"const response = await fetch(
'https://gigfreight.com/api/v1/marketplace/loads?origin_country=PL&vehicle_type=curtainsider',
{
headers: {
'Authorization': 'Bearer gf_your_api_key',
'Accept': 'application/json',
},
}
)
const { data, pagination } = await response.json()
console.log(`Found ${pagination.total} loads`)
data.forEach(load => {
console.log(`${load.pickup_city} → ${load.delivery_city}: €${load.rate}`)
})import requests
API_KEY = "gf_your_api_key"
BASE_URL = "https://gigfreight.com/api/v1"
headers = {
"Authorization": f"Bearer {API_KEY}",
"Accept": "application/json",
}
params = {
"origin_country": "DE",
"destination_country": "FR",
"limit": 50,
"page": 1,
}
response = requests.get(f"{BASE_URL}/loads", headers=headers, params=params)
response.raise_for_status()
result = response.json()
print(f"Found {result['pagination']['total']} loads")
for load in result["data"]:
print(f"{load['pickup_city']} → {load['delivery_city']}: €{load['rate']}")Оформіть тариф Elite і створіть свій перший ключ у розділі Налаштування → API-ключі.