← Business

Company API

The API is for companies that want to manage listings from their own system. Listings behave the same as those imported from a feed — the same fields and rules.

Key

Create the API key in your company account (Account → Company → API and import). The key is shown once; you can revoke it or create a new one at any time. Publishing via the API is possible once the company is verified.

Authorization: Bearer as_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Requests

{id} — the listing ID in your system (letters, digits, dot, hyphen, underscore, colon; up to 120 characters). The listing is updated by this ID, so it must stay the same.

Example

curl -X PUT https://autoskelbimai.com/api/v1/listings/A-1042 \
  -H "Authorization: Bearer as_xxxxxxxx…" -H "Content-Type: application/json" \
  -d '{
    "category": "automobiliai", "make": "Volkswagen", "model": "Golf", "version": "1.4 TSI Highline",
    "year": 2017, "mileage": 98000, "price": 12900, "currency": "EUR",
    "fuel": "petrol", "gearbox": "manual", "body": "hatchback", "power_kw": 92,
    "vin": "WVWZZZAUZHW000000", "city": "Vilnius", "country": "LT",
    "description": "…", "description_lang": "lt",
    "photos": ["https://example.com/foto/1.jpg", "https://example.com/foto/2.jpg"]
  }'

Response: 201 — created, 200 — updated or unchanged.

{"result": "created", "id": 2381, "external_id": "A-1042", "status": "active", "url": "https://autoskelbimai.com/skelbimas/2381-volkswagen-golf-1-4-tsi-highline", …}

Removal: DELETE /api/v1/listings/A-1042?reason=sold

Fields

Only “price” is required (greater than 0). Category is our category slug (e.g. automobiliai, motociklai-visi, sunkvezimiai-visi, automobiliu-dalys); make and model are ordinary names (recognised automatically).

id url category deal make model version title year month mileage hours price currency fuel gearbox body drive power_kw power_hp engine_cc color doors seats vin condition country city description description_lang negotiable vat phone photos fuel_city fuel_highway fuel_combined co2

Photos — an array of public image URLs (up to 30); downloaded in the background within a few minutes. When the list changes, the photos are updated.

Automatic import feed

The same fields work in an XML, CSV or JSON feed whose address you enter in your company account. The feed is checked regularly; listings missing from the feed for more than 3 days are hidden.

<listings>
  <listing>
    <id>A-1042</id><category>automobiliai</category><make>Volkswagen</make><model>Golf</model>
    <year>2017</year><mileage>98000</mileage><price>12900</price><currency>EUR</currency>
    <photos><photo>https://example.com/foto/1.jpg</photo></photos>
  </listing>
</listings>

Limits and errors

Up to 600 requests per minute per key. Errors are returned as JSON with “error” and “message” fields.