Machineseeker & TruckScout24 - Listing Management API
Category
Get category tree
Get all categories with mapping to legacy category IDs (used for the legacy CSV import).
/json/category/tree
Scopes
Parameters
Header parameters
| Name |
Description |
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Responses
Listing
Activate a listing
Activate a paused listing. Newly created listings are active by default.
/json/listing/activate
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Update a listing
Update a listing.
/json/listing
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Create listing
Create a listing.
/json/listing
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Delete a listing
Delete a listing.
/json/listing
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Extend the listing expiry date
/json/listing/extend
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Get a listing
Get data for an existing listing or, without an ID, get the data structure for creating a new listing. Temporary images are generated when calling the API. Please note that only listings which were created via the API are obtainable.
/json/listing
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Query parameters
| Name |
Description |
| id |
Integer
Machineseeker/TruckScout24-ID of listing
|
Responses
Get all listings
Get all listings of this user.
/json/listing/all
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Query parameters
| Name |
Description |
| page |
Integer
100 listings per page are delivered
|
Responses
Pause a listing
/json/listing/pause
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
ListingAsset
Upload document
Upload documents to the server before saving a listing.
/json/listing-asset/document
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Upload image
Upload images to the server before saving a listing.
/json/listing-asset/image
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Body parameters
Responses
Product
Get product properties
Add a property to the listing by passing the "name" and the desired value to "property" in the create request.
/json/product/properties
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Query parameters
| Name |
Description |
| productType |
String
Optionally filter properties by product type
|
Responses
Get product types
Pass the "name" of the product type to "productType" in the create request.
/json/product/types
Scopes
Parameters
Header parameters
| Name |
Description |
| Authorization |
String
(Bearer {TOKEN})
Authorize API requests with this header field. The token can be generated in the user account under "Useful Functions" > "Data Import" > "Real-time API": https://www.machineseeker.com/import/auto/api-token or https://www.truckscout24.com/import/auto/api-token
|
| Content-Type |
String
(application/json)
Request content is always provided in JSON syntax.
|
| Accept-Language |
String
(LL-CC)
The Accept-Language header should be in the format LL-CC, where LL is a two-letter lowercase language code according to ISO-639-1 and CC is a two-letter lowercase country code according to ISO-3166-1 alpha-2. E.g. "en-us", "en-gb" or "de-de". If Accept-Language is not set, then "en-us" is used by default. If Accept-Language is set but the country code CC in <LL-CC> is not valid, then a default country for language LL is chosen. If the language code is not valid, then "en-us" is used by default. If the country does not matter, it is also possible to just pass the language, e.g. "es". A default country is chosen in this case.
|
Query parameters
| Name |
Description |
| categoryId |
Integer
Optionally filter types by category
|
Responses