API dokumentācija

JSON REST API sludinājumu, kandidātu un statistikas pārvaldībai. Cenas ir eiro, laiki ISO 8601 formātā.

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 atslēgu (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.

Listings

`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
  }'

Publicēšana izmanto plāna kvotu un tad kredītus. Ja kredītu nepietiek, atbildē ir "pending": "credits" un sludinājums paliek melnrakstā.

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".

Applications

`GET`	`/api/v1/applications?listing=:id`	Pieteikumi jūsu vakancēm
`PATCH`	`/api/v1/applications/:id`	Mainīt atlases posmu `{"stage": "interview"}`

Stats

`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`	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
`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` · `request_in_progress`	Darbība nav iespējama pašreizējā stāvoklī
`415`	`unsupported_media_type`	Sūtiet Content-Type: application/json
`422`	`validation_failed` · `idempotency_key_reused`	Lauku kļūdas: "fields" (teksts) un "codes" (kodi)
`429`	`rate_limited`	Pārsniegts pieprasījumu limits

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 pieprasījumi minūtē.

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"] }
  }
}

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