api.tipmoto.com » API documentation » Agendas » Dealers list » Dealer » Moto

Agenda moto

Contains motorcycle ads

Sub-agendas overview

Name Machine name WRITE
Photos photo YES
Video video YES
Price history ceny NO
Statistics stats NO

Agenda features

Name Options
Supported methods GET, PUT/POST, DELETE
Support for detail levels ✔
Support for filtering ✔
Support for full-text search ✔
Support for pagination ✔
Support for sorting ✔
Support for external identifiers ✔
Support for schemas https://api.tipmoto.com/schemas/moto-{export|import}{-enum}.{xsd|rng}
Support for ?fail-on-warning ✔
Support for dry-run ✔
Returns location ✔

Agenda elements

Machine name Name Type Information rw iu P S ➀ ➁
id Ad ID in the agenda moto integer         ✔ ✔ ✔
idApi external ad ID string 64   ✔     ✔ ✔ ✔
aktivni active select Possible values:
  • 0 No
  • 1 Yes
  • 2 Dealer website
Attribute firstInactive: only when importing data = inactive at first, then no effect		   ✔ ✔ ✔ ✔ ✔
lastModified Last modified datetime Format YYYY-MM-DD HH:MM:SS ✔ ✔ ✔ ✔ ✔
pobocka Branch string 128 Displayed and processed only if the dealer has more than one branch           ✔
pobocka@id Branch ID integer Displayed and processed only if the dealer has more than one branch ✔   ✔ ✔   ✔
kontakt Contact element Contact of the ad – phones, e-mail and website shown with the ad instead of the branch details (the address, seller name and opening hours remain those of the branch). The dealer's contacts are in the agenda kontakt.
Shown only for dealers with at least one contact, then with every ad (including id="0"). The ref attribute links to the contact; it is missing for id="0".		           ✔
kontakt@id Contact ID integer 0 = default contact of the branch, otherwise the ID of a contact of the same dealer. A contact the dealer does not have (e.g. a deleted one) is output as 0.
Writing <kontakt id="N"/>: without the element or with an empty id the contact is not changed, a new ad gets 0. A non-numeric ID returns the error “Invalid contact ID '…'”, a non-existent contact or a contact of another dealer returns the error “Dealer '…' has no contact id '…'”.		 ✔     ✔   ✔
manufacturer Manufacturer string 64 The manufacturer can be imported as text
The manufacturer is from the agenda manufacturer		 ✔ ✔ ✔ ✔   ✔
manufacturer@id Manufacturer ID integer On import the ID takes precedence. Either the text or the ID is required. ✔ ✔ ✔ ✔   ✔
nazev Name of the motorcycle / quad string 64   ✔ ✔ ✔ ✔   ✔
model Model of the motorcycle / quad string 64 The model can be imported as text
The model is from the agenda model		 ✔ ✔   ✔   ✔
model@id Model ID integer On import the ID takes precedence. ✔ ✔   ✔   ✔
zarazenimoto Category string 64 The category can be imported as text
The category is from the agenda zarazenimoto		 ✔ ✔ ✔ ✔   ✔
zarazenimoto@id Category ID integer On import the ID takes precedence. Either the text or the ID is required. ✔ ✔ ✔ ✔   ✔
stav Vehicle condition select Possible values:
  • ojetá = used
  • nová = new
  • předváděcí = demonstrator
  • bouraná = damaged
  • veterán = vintage
 ✔ ✔ ✔ ✔    
objem Engine capacity string 16 The engine capacity is from the agenda objem ✔ ✔ ✔ ✔    
vykon Power in kW decimal 4,1   ✔ ✔   ✔    
vyrobeno Year of manufacture string 16 Normally a 4-digit number (year), but historically a string ✔ ✔   ✔    
doProvozu Year of first registration string 16 Normally a 4-digit number (year), but historically a string ✔ ✔   ✔    
cena Price integer Value 0 = price negotiable (not allowed for new motorcycles) ✔ ✔ ✔ ✔    
cena@historie Price history href Link to the price history (sub-agenda ceny)            
cenaMena Currency string 8 In practice it takes these values:
  • Kč
  • €
 ✔ ✔ ✔ ✔    
cenaOld Original price integer Value 0 = not set ✔ ✔     ✔  
dph VAT deductible select Possible values:
  • 0 No
  • 1 Yes
  • 2 not set
 ✔ ✔ ✔ ✔    
splatky Instalments / leasing select Possible values:
  • 0 No
  • 1 Yes
  • 2 not set
 ✔ ✔ ✔ ✔    
najeto Mileage value string 16 States the mileage as a number, but historically text is allowed. ✔ ✔   ✔    
najetoMira Mileage unit string 8 In practice it takes these values:
  • km
  • mil
  • mth
 ✔ ✔   ✔    
dostupnostmoto Availability integer The availability is from the agenda dostupnostmoto ✔ ✔ ✔ ✔    
puvodmoto Country of origin select The country of origin is from the agenda puvodmoto ✔ ✔ ✔ ✔    
tp Registration certificate (TP) select Possible values:
  • 0 No
  • 1 Yes
  • 2 not set
 ✔ ✔ ✔ ✔    
stk Roadworthiness test (STK) select Possible values:
  • 0 No
  • 1 Yes
  • 2 not set
 ✔ ✔ ✔ ✔    
stkDo STK valid until string Format MM/RRRR (month/year) ✔ ✔        
serviska Service book select Not used on TipMoto. Only for other advertising servers
Possible values:
  • 0 No
  • 1 Yes
  • 2 not set
 ✔ ✔        
vin VIN string 32   ✔ ✔   ✔    
prevodovka Gearbox select Possible values:
  • empty
  • auto
  • manual
 ✔ ✔   ✔    
takt Number of strokes select Possible values:
  • empty
  • 2T
  • 4T
 ✔ ✔   ✔    
abs ABS select Not used on TipMoto. Only for other advertising servers
Possible values:
  • empty not set (import only)
  • 0 No
  • 1 Yes
  • 2 not set (for both export and import) - default value
 ✔ ✔        
valce Number of cylinders select Not used on TipMoto. Only for other advertising servers
Possible values:
  • empty = not set
  • Elektromotor = electric motor
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
 ✔ ✔        
majitelu Number of owners select Not used on TipMoto. Only for other advertising servers
Possible values:
  • empty, 0 = not set
  • positive integer = number of owners
 ✔ ✔        
labels/label Label select Possible values:
  • Premium selection only for BMW motorcycles
  • Harley-Davidson Originals
  • Importér = importer
 ✔ ✔        
poznamkaInterni Internal note string 64   ✔ ✔   ✔    
nove new select Kept for compatibility reasons. Replaced by stav
Possible values:
  • 0 No
  • 1 Yes
 ✔   ✔ ✔   ✔
predvadeci In demonstrator condition select Kept for compatibility reasons. Replaced by stav
Possible values:
  • 0 No
  • 1 Yes
 ✔   ✔ ✔    
bourane In damaged condition select Kept for compatibility reasons. Replaced by stav
Possible values:
  • 0 No
  • 1 Yes
 ✔   ✔ ✔    
veteran It is a vintage motorcycle select Kept for compatibility reasons. Replaced by stav
Possible values:
  • 0 No
  • 1 Yes
 ✔   ✔ ✔    
akce Special offer select Possible values:
  • 0 No
  • 1 Yes
 ✔ ✔ ✔      
url URL at the dealer string 255   ✔ ✔        
youtube Link to a YouTube video. If the video ID cannot be determined from the link, the API returns a warning and the video is not shown with the ad. string 1024   ✔ ✔        
vlozeniCas Time inserted datetime Format YYYY-MM-DD HH:MM:SS       ✔    
editaceCas Time of last update datetime Format YYYY-MM-DD HH:MM:SS, may be empty       ✔    
urlTipmoto URL on TipMoto.com string 255              
urlTipmotoSubdomain URL on the subdomain string 255              
popis Description text May contain HTML ✔ ✔        
photos@ignoreimport Do not import photos logical Used only when importing. Possible values:
  • true
  • false
 ✔          
photos@forceupdate Overwrite photos logical Used only when importing. Possible values:
  • true
  • false
Note: all photos are downloaded again and get new IDs (and new URLs). Do not send it permanently, only when you really need to load the photos again.		 ✔          
photos@reorder Sort photos by the import logical Used only when importing. Possible values:
  • true = the gallery is sorted by the order of the photos in photos
  • false = only main and sortOrder change the order (default)
See Order and main photo.		 ✔          
photo@modify Photo adjustment select Used only when importing. Possible values:
  • trim = if the photo has a border, it is cropped automatically
 ✔          
photo/id Photo ID integer Refers to the agenda photo            
photo/url Photo URL string 255   ✔          
photo/main Main photo select Possible values:
  • 1 or true Yes – the photo becomes the main photo and moves to position 1
  • 0 or false No – on its own it does not change the order
On export always 0 or 1.
Without main, the import does not change the main photo (for an ad without photos, the first photo is the main one; the exception when the main photo is deleted is described in Order and main photo). If several photos have main = 1, the first of them applies.
An invalid value is ignored and the response contains a warning, so with ?fail-on-warning the ad is not processed.		 ✔          
photo/sortOrder Photo order integer Position of the photo in the ad gallery, 1 = main photo.
On export, it is the position at which the website shows the photo.
On import optional: the absolute position at which the photo is placed; the other photos fill the remaining positions. A number greater than the number of photos means the end of the gallery. sortOrder other than 1 together with main = 1 (or 1 together with main = 0) is an error and the ad is not processed. An invalid value (other than a whole number from 1) is ignored and the response contains a warning.		 ✔          
photo/width Photo width px integer              
photo/height Photo height px integer              
photo/stamp Photo change stamp char 128 On export it contains the datetime of the last change
On import any text can be used.		 ✔          
videos@ignoreimport Do not import videos logical Used only when importing. Possible values:
  • true
  • false
 ✔          
videos@forceupdate Overwrite videos logical Used only when importing. Possible values:
  • true
  • false
 ✔          
video/status Processing status select Possible values
  • OK
  • Chyba = error
  • Zpracováváno = processing
            
video/statusChyba Processing error string 255 If video/status == Chyba, it contains a text description of the error            
video/stamp Video change stamp char 128 On export it contains the datetime of the last change
On import any text can be used.		 ✔          
video/delkaSec Video length integer Video length in seconds            
video/nahled Thumbnail string 255 URL of the thumbnail image            
video/sources Videos element Individual videos in different resolutions            
video/source/res Resolution select Video resolution type.
Possible values:
  • 180p
  • 270p
  • 406p
  • 720p
  • 1080p
            
video/source/url URL string 255 URL of the given resolution            
video/source/width Width integer Video width in px            
video/source/height Height integer Video height in px            
video/originalUrl Original URL string 1024 If the video was copied from a URL, this is the link it was copied from ✔          
video/originalFile Original file string 255 If the video was copied successfully, this is the original video, which is subsequently transcoded.            
userValue/nazevApp User value name string 255 Name of the user-defined value for the application. ✔          
userValue/nazevApp@id User value ID integer ID of the user-defined value ✔          
userValue/hodnota User value text Value ✔          
stats Ad statistics element Lifetime counters of the ad (cleaned of bots etc.) – the same block as in the archive. Only in detail levels full and custom:stats, in the record list and in the record detail. The block does not require the statsperm permission – the permission with which the login reads the record is enough.            
stats@ref Detailed statistics href Link to the detailed statistics of the ad by day (sub-agenda stats). They require the statsperm permission and return 402 without it.            
stats/zobrazeni Number of ad views integer              
stats/odpovedi Number of replies via the ad's form integer              
stats/urlKliknuti Number of clicks on the product URL integer              

rw = writable
iu = ignoreonupdate can be used
P = required element
S = the element can be used for filtering and sorting
➀ = included in detail level id
➁ = included in detail level summary

TipMoto.com Contact us