Machineseeker - Listing Management API

Category

Get category tree

Get all categories with mapping to legacy category IDs (used for the legacy CSV import).


/ad/category/get-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 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 languge 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

Edit

Get listing product types

Pass the "name" of the product type to "productType" in the edit-push request.


/ad/edit/get-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
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 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 languge 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

Get listing properties

Add property to the listing by passing the "name" and the desired value to "property" in the edit-push request.


/ad/edit/get-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
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 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 languge 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 listing to edit

Get data for an existing listing or (without ID) get the data structure for creating a new listing. Temporary images are generated when calling the API.


/ad/edit/get

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
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 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 languge 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-ID of listing

Responses

Get all listings

Get all listings of this user.


/ad/edit/get-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
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 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 languge 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

Create/edit listing

Create or edit a listing.


/ad/edit/push

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
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 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 languge 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
Description

Responses

Media

Push document

Push documents to server before saving a listing.


/ad/doc/push

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
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 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 languge 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
Description

Responses

Push image

Push images to the server before saving a listing.


/ad/image/push

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
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 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 languge 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
Description

Responses

UserAd

Activate a listing


/user/ad/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
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 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 languge 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
Description

Responses

Delete a listing


/user/ad/delete

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
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 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 languge 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
Description

Responses

Extend listing expiry date


/user/ad/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
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 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 languge 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
Description

Responses

Pause a listing


/user/ad/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
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 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 languge 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
Description

Responses