Bezmaksas pārlūkošana · tiešs kontakts ar pārdevēju · bez starpniekiem
Lietuva
Izvēlieties valsti
LatvijaLietuvaIgaunijaEesti
LV
Kategorijas

API dokumentācija

Saņemt API atslēgu

JSON 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:writeizveidot, 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:spendkopā 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
applicationslasīt darba pieteikumus, arī kandidātu tālruni un e-pastu, un mainīt to posmu
stats:readskatī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=1Jūsu sludinājumi, 50 lapā
POST/api/v1/listingsIzveidot un publicēt
GET/api/v1/listings/:idViens sludinājums
PATCH/api/v1/listings/:idMainīt cenu, virsrakstu, aprakstu vai statusu (active/inactive)
DELETE/api/v1/listings/:idDzēst
POST/api/v1/listings/:id/imagesPievienot foto (multipart lauks "photos", līdz 10)
DELETE/api/v1/listings/:id/images/:imageDzēst foto
POST/api/v1/listings/:id/promoteTOP, 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=1Pieteikumi jūsu vakancēm
PATCH/api/v1/applications/:idMainīt atlases posmu {"stage": "interview"}

Statistika

GET/api/v1/meKonts, plāns, kredīti
GET/api/v1/stats?days=30Skatījumi, kontakti, saglabāšanas pa dienām

Kļūdas

400invalid_json · bad_requestNederīgs JSON
401unauthorizedTrūkst vai nederīga atslēga
402insufficient_creditsNepietiek kredītu publicēšanai vai izcelšanai
403plan_required · account_disabledPlāns neietver API vai konts ir bloķēts
403insufficient_scope · spend_cap_reachedAtslēgai nav laukā "scope" nosauktās atļaujas, vai maksājums pārsniegtu tās mēneša tēriņu limitu
404not_foundNav atrasts vai nepieder jums
405method_not_allowedMetode šim ceļam nav atļauta (skat. galveni Allow)
409expired · not_published · auction_price_locked · withdrawn · closed · request_in_progress · invalid_status_change · not_deliverable · drafts_limitDarbība nav iespējama pašreizējā stāvoklī
413payload_too_largePieprasījums pārāk liels (JSON līdz 100 kB, foto līdz 8 MB)
415unsupported_media_typeSūtiet Content-Type: application/json
422validation_failed · idempotency_key_reused · incomplete · banned_textLauku kļūdas: "fields" (teksts) un "codes" (kodi)
429rate_limitedPārsniegts pieprasījumu limits
500server_errorKļū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_listingsMeklēšana pēc teksta, kategorijas, reģiona, cenas un filtriem
get_listingSludinājuma dati, cenas vērtējums, cenu vēsture, izsole, pārdevēja uzticamība
check_priceVai cena ir laba? Salīdzinājums ar līdzīgiem auto, dzīvokļiem, mājām, telefoniem
best_offersLētākā ceturtdaļa tirgū un lielākās cenu samazināšanas
price_trendsNedēļas mediānās cenas, cenu samazinājumi un pārdotais
market_overviewViss tirgus: apjomi, pieprasījums, auto un dzīvokļu cenas
find_opportunitiesGadījuma darbi, vakances, “pērk” sludinājumi, stundas, izsoles, atdod bez maksas
list_categoriesKategorijas, 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