API dokumentācija
Saņemt API atslēguJSON REST API sludinājumu, kandidātu un statistikas pārvaldībai. Cenas ir eiro, laiki ISO 8601 formātā.
Sadarbībai, reklāmai un API: partners@baltic-market.org
Autentifikācija
Katram pieprasījumam pievienojiet galveni Authorization ar atslēgu no sadaļas “Integrācijas”. Atslēgas glabājiet servera pusē.
curl https://baltic-market.org/api/v1/me \ -H "Authorization: Bearer tg_live_…"
Limits: 120 pieprasījumi minūtē uz kontu, visām atslēgām kopā (galvenes X-RateLimit-*).
Droši atkārtojumi
Pievienojiet POST pieprasījumiem galveni Idempotency-Key (līdz 100 simboliem). Ja savienojums pārtrūkst un pieprasījums tiek atkārtots ar to pašu atslēgu un saturu, saņemsiet pirmo atbildi (galvene Idempotent-Replayed) – sludinājums netiks izveidots divreiz un izcelšana netiks apmaksāta divreiz. Atslēgas glabājas 24 stundas.
curl -X POST https://baltic-market.org/api/v1/listings \
-H "Authorization: Bearer tg_live_…" -H "Content-Type: application/json" \
-H "Idempotency-Key: dms-order-1001" -d '{ … }'
Pieprasījumu saturs ir JSON objekts ar pareiziem tipiem; nezināmi lauki un atribūti tiek noraidīti ar paskaidrojumu. Katrai atbildei ir galvene X-Request-Id – norādiet to, rakstot atbalstam.
Atslēgu atļaujas
Katrai atslēgai ir atļaujas, kas atzīmētas tās izveidē; konta (/me) un sludinājumu lasīšanai atļauja nav vajadzīga. Jaunām atslēgām pēc noklusējuma ir listings:write un stats:read. Katrai sistēmai vai piegādātājam dodiet savu atslēgu tikai ar vajadzīgo. GET /api/v1/me parāda izsaucošās atslēgas atļaujas un tēriņus.
listings:write | izveidot, labot un dzēst sludinājumus un to fotoattēlus; publicēt no plāna kvotas un pagarināt, ja pagarināšana ir bez maksas |
credits:spend | kopā ar listings:write maksāt no kredītu atlikuma: maksas publicēšana, pagarināšana, TOP vieta, izcelšana, steidzami un pacelšana uz augšu |
applications | lasīt darba pieteikumus, arī kandidātu tālruni un e-pastu, un mainīt to posmu |
stats:read | skatījumi, kontaktu atvēršanas un saglabāšanas pa dienām |
Atslēgai var būt mēneša tēriņu limits kredītos (kalendārais mēnesis, Latvijas laiks). Maksājums virs limita tiek atteikts ar 403 spend_cap_reached, bet atslēgai bez credits:spend — ar 403 insufficient_scope; nekas netiek iekasēts. Šie atteikumi netiek saglabāti Idempotency-Key vajadzībām, tāpēc tas pats pieprasījums, nosūtīts vēlreiz (ar atslēgu, kurai ir lielāks limits, vai nākamajā mēnesī), tiek apstrādāts no jauna. Jauns sludinājums, kas maksātu kredītus, tad paliek melnraksts, un iemesls ir laukā "pending". Atslēgām, kas izveidotas pirms atļauju ieviešanas, ir visas atļaujas un nav limita: aizstājiet tās ar jaunām.
Sludinājumi
GET | /api/v1/listings?status=active&page=1 | Jūsu sludinājumi, 50 lapā |
POST | /api/v1/listings | Izveidot un publicēt |
GET | /api/v1/listings/:id | Viens sludinājums |
PATCH | /api/v1/listings/:id | Mainīt cenu, virsrakstu, aprakstu vai statusu (active/inactive) |
DELETE | /api/v1/listings/:id | Dzēst |
POST | /api/v1/listings/:id/images | Pievienot foto (multipart lauks "photos", līdz 10) |
DELETE | /api/v1/listings/:id/images/:image | Dzēst foto |
POST | /api/v1/listings/:id/promote | TOP, izcelšana, steidzami, pacelšana vai pagarināšana no kredītiem |
curl -X POST https://baltic-market.org/api/v1/listings \
-H "Authorization: Bearer tg_live_…" -H "Content-Type: application/json" \
-d '{
"category": "transport/cars", "deal": "sell",
"title": "Volkswagen Golf 1.6 TDI, 2015",
"body": "Serviced at the dealer, one owner, winter tyres included.",
"price": 8500, "region": "riga", "city": "Purvciems",
"attrs": { "brand": "Volkswagen", "model": "Golf", "year": 2015, "mileage": 180000, "fuel": "diesel" },
"days": 30,
"seller_kind": "trader",
"trader": { "name": "Auto SIA", "reg_no": "40003000000", "address": "Brīvības iela 1, Rīga", "certified": true }
}'
Publicēšana izmanto plāna kvotu un tad kredītus. Ja kredītu nepietiek, atbildē ir "pending": "credits" un sludinājums paliek melnrakstā.
Norādiet, kas pārdod (ES Digitālo pakalpojumu akts): "seller_kind": "private" vai "trader"; uzņēmums norāda arī "trader" ar nosaukumu, reģistrācijas numuru, adresi un "certified": true — apņemšanos piedāvāt tikai preces un pakalpojumus, kas atbilst ES tiesību aktiem. Bez tā sludinājums paliek melnraksts (pending "seller_kind"), kamēr neesat to vienreiz norādījuši vietnē.
curl -X POST https://baltic-market.org/api/v1/listings/123/images -H "Authorization: Bearer tg_live_…" -F "photos=@front.jpg" -F "photos=@interior.jpg"
curl -X POST https://baltic-market.org/api/v1/listings/123/promote -H "Authorization: Bearer tg_live_…" -H "Content-Type: application/json" -d '{ "top": 7, "highlight": 7, "bump": true }'
top / highlight / urgent: 7, 14 vai 30 dienas; renew: 7, 14, 30 vai 60; bump: true. Plāna atlaide tiek piemērota, summa atbildē ir "charged".
Pieteikumi
GET | /api/v1/applications?listing=:id&page=1 | Pieteikumi jūsu vakancēm |
PATCH | /api/v1/applications/:id | Mainīt atlases posmu {"stage": "interview"} |
Statistika
GET | /api/v1/me | Konts, plāns, kredīti |
GET | /api/v1/stats?days=30 | Skatījumi, kontakti, saglabāšanas pa dienām |
Kļūdas
400 | invalid_json · bad_request | Nederīgs JSON |
401 | unauthorized | Trūkst vai nederīga atslēga |
402 | insufficient_credits | Nepietiek kredītu publicēšanai vai izcelšanai |
403 | plan_required · account_disabled | Plāns neietver API vai konts ir bloķēts |
403 | insufficient_scope · spend_cap_reached | Atslēgai nav laukā "scope" nosauktās atļaujas, vai maksājums pārsniegtu tās mēneša tēriņu limitu |
404 | not_found | Nav atrasts vai nepieder jums |
405 | method_not_allowed | Metode šim ceļam nav atļauta (skat. galveni Allow) |
409 | expired · not_published · auction_price_locked · withdrawn · closed · request_in_progress · invalid_status_change · not_deliverable · drafts_limit | Darbība nav iespējama pašreizējā stāvoklī |
413 | payload_too_large | Pieprasījums pārāk liels (JSON līdz 100 kB, foto līdz 8 MB) |
415 | unsupported_media_type | Sūtiet Content-Type: application/json |
422 | validation_failed · idempotency_key_reused · incomplete · banned_text | Lauku kļūdas: "fields" (teksts) un "codes" (kodi) |
429 | rate_limited | Pārsniegts pieprasījumu limits |
500 | server_error | Kļūda mūsu pusē; atbildē ir X-Request-Id — norādiet to, rakstot atbalstam |
MCP serveris mākslīgajam intelektam
Pievienojiet Tirgus tirgus datus Claude vai citam MCP klientam: AI var meklēt sludinājumus, novērtēt cenas, atrast labākos piedāvājumus, sekot cenu tendencēm un atrast iespējas nopelnīt. Tikai publiski dati, tikai lasīšana – bez kontaktiem un personas datiem.
search_listings | Meklēšana pēc teksta, kategorijas, reģiona, cenas un filtriem |
get_listing | Sludinājuma dati, cenas vērtējums, cenu vēsture, izsole, pārdevēja uzticamība |
check_price | Vai cena ir laba? Salīdzinājums ar līdzīgiem auto, dzīvokļiem, mājām, telefoniem |
best_offers | Lētākā ceturtdaļa tirgū un lielākās cenu samazināšanas |
price_trends | Nedēļas mediānās cenas, cenu samazinājumi un pārdotais |
market_overview | Viss tirgus: apjomi, pieprasījums, auto un dzīvokļu cenas |
find_opportunities | Gadījuma darbi, vakances, “pērk” sludinājumi, stundas, izsoles, atdod bez maksas |
list_categories | Kategorijas, filtri un reģioni |
Attālināti (HTTP)
Claude: Iestatījumi → Savienotāji → Pievienot pielāgotu savienotāju, un ievadiet šo adresi. Atslēga nav vajadzīga; limits 120 vienības minūtē: katrs pieprasījums ir 1, bet check_price, best_offers, price_trends, market_overview un find_opportunities — 5. Limits tiek skaitīts katrai IPv4 adresei vai IPv6 /48 tīklam; kad serviss ir noslogots, klienti ar dažiem pieprasījumiem minūtē joprojām tiek apkalpoti, un tikai pārslodzes gadījumā jāgaida visiem (skat. Retry-After).
https://baltic-market.org/mcp
Lokāli (stdio)
Claude Desktop vai IDE konfigurācijā (servera kopija ar to pašu datubāzi):
{
"mcpServers": {
"tirgus": {
"command": "node", "args": ["/path/to/market/scripts/mcp-stdio.js"],
"env": { "MARKET_DB": "/path/to/market/data/production/market.db", "MARKET_ORIGIN": "https://baltic-market.org" }
}
}
}
Gatavas uzvednes: market_report, deal_hunter, earn_money.
CSV
CSV failā pirmā rinda ir kolonnu nosaukumi; atribūti ar prefiksu a_ (tie paši, kas filtros). Vairākas vērtības atdaliet ar |. Der gan komats, gan semikols.
category,deal,title,body,price,region,city,a_brand,a_model,a_year transport/cars,sell,"Škoda Octavia 2.0 TDI","Serviced, new tyres, two keys.",9900,riga,Teika,Skoda,Octavia,2017