Agenda motoceny
The MotoCeny price service: withdrawn motorcycle ads with their price and how long each ad was on the server.
It lists the same as the client interface at www.tipmoto.com/motoceny/, with the same rules.
Access to the agenda requires the login to be the dealer's own website (setting firma_self) – a third-party export server has no access to the agenda –
and the dealer to have motorcycle advertising activated. If you also have the MotoCeny service activated, you see the whole market (only ads of dealers that have joined the service);
without it you see only your own dealer's ads. Without permission the agenda returns 402.
Neither the ad ID nor the selling dealer is returned. You can recognise your own ads by the element vlastni.
Detail levels: only detail=custom:… is supported; without the parameter all elements are listed.
Pagination: both the default and the maximum limit is 1000.
Full-text search: the parameter fulltext= uses the same search as the website; this agenda does not know ftx-op and ftx-loc.
Agenda features
| Name | Options |
|---|---|
| Supported methods | GET |
| Support for detail levels | ✔ only custom |
| Support for filtering | ✔ |
| Support for full-text search | ✔ only fulltext= |
| Support for pagination | ✔ limit at most 1000 |
| Support for sorting | ✔ |
| Support for external identifiers | ✘ |
Support for schemas |
https://api.tipmoto.com/schemas/motoceny.{xsd|rng} |
Support for ?fail-on-warning |
✘ |
| Support for dry-run | ✘ |
Returns location |
✘ |
Agenda elements
| Machine name | Name | Type | Information | S | ||||
|---|---|---|---|---|---|---|---|---|
manufacturer |
Manufacturer | string 64 |
✔ | |||||
nazev |
Ad title | string 64 |
✔ | |||||
model |
Model | string 64 |
Model from the list. May be empty (it was not entered for older ads). The attribute id is the model ID in the list, ref a link to its detail. If the model is not from the list, the attributes are omitted entirely – not left empty.Filtering and sorting are possible by model@id |
✔ | ||||
zarazenimoto |
Type (category) | string 64 |
✔ | |||||
objem |
Engine capacity | string 16 |
In ccm.
|
✔ | ||||
vykon |
Power | decimal 4,1 |
In kW. 0.0 = not set |
✔ | ||||
vyrobeno |
Year of manufacture | string 8 |
May be empty. For filtering and sorting it is converted to a number. | ✔ | ||||
najeto |
Mileage | string 16 |
May be empty | ✔ | ||||
najetoMira |
Mileage unit | string 8 |
Usually km or mi |
✔ | ||||
stk |
Roadworthiness test (STK) | select |
Possible values:
|
✔ | ||||
cena |
Price | integer |
Advertised price at the time the ad was withdrawn. 0 = price negotiable |
✔ | ||||
cenaMena |
Currency | string 8 |
Usually Kč or €; for historical reasons also other text values |
✔ | ||||
vlozeniCas |
Date inserted | date |
Day only, without time – the same as the withdrawal date | ✔ | ||||
smazaniCas |
Date withdrawn | date |
Day only, without time – the same as on the website | ✔ | ||||
delkaProdeje |
Advertising period in days | integer |
Number of days the ad was on the server.
|
✔ | ||||
vlastni |
Own ad | select |
Is this an ad of your dealer?
filter=vlastni='1' |
✔ |
rw = writable
P = required element
S = the element can be used for filtering and sorting
➀ = included in detail level id
➁ = included in detail level
summary
