Category

GET/categories

Categories

Get all categories.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Request

GET
/categories
curl -X GET https://api.olx.ba/categories \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": [
			{
				"id": 2,
				"name": "Nekretnine",
				"name_singular": "Nekretnine",
				"slug": "nekretnine",
				"parent_id": null,
				"order": 100,
				"top_category": true,
				"highlighted": true,
				"shipping_available": false,
				"sensitive_content": false,
				"post_option": null,
				"show_price": true,
				"show_brand": false,
				"brand_required": false,
				"model_required": false,
				"has_models": false,
				"show_condition": true,
				"show_map": false,
				"listing_fee": 0,
				"base_listing_price": 0,
				"icon": "real-estate"
			},
			{
				"id": 3,
				"name": "Mobilni ure\u0111aji",
				"name_singular": "Mobilni ure\u0111aji",
				"slug": "mobilni-uredjaji",
				"parent_id": null,
				"order": 100,
				"top_category": true,
				"highlighted": true,
				"shipping_available": true,
				"sensitive_content": false,
				"post_option": null,
				"show_price": true,
				"show_brand": true,
				"brand_required": false,
				"model_required": false,
				"has_models": false,
				"show_condition": true,
				"show_map": false,
				"listing_fee": 0,
				"base_listing_price": 0,
				"icon": "mobile-phones"
			},
	]
}

GET/categories/:id

Children categories

Get children categories.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Request

GET
/categories/:id
curl -X GET https://api.olx.ba/categories/:id \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": [
			{
				"id": 2,
				"name": "Nekretnine",
				"name_singular": "Nekretnine",
				"slug": "nekretnine",
				"parent_id": null,
				"order": 100,
				"top_category": true,
				"highlighted": true,
				"shipping_available": false,
				"sensitive_content": false,
				"post_option": null,
				"show_price": true,
				"show_brand": false,
				"brand_required": false,
				"model_required": false,
				"has_models": false,
				"show_condition": true,
				"show_map": false,
				"listing_fee": 0,
				"base_listing_price": 0,
				"icon": "real-estate"
			},
			{
				"id": 3,
				"name": "Mobilni ure\u0111aji",
				"name_singular": "Mobilni ure\u0111aji",
				"slug": "mobilni-uredjaji",
				"parent_id": null,
				"order": 100,
				"top_category": true,
				"highlighted": true,
				"shipping_available": true,
				"sensitive_content": false,
				"post_option": null,
				"show_price": true,
				"show_brand": true,
				"brand_required": false,
				"model_required": false,
				"has_models": false,
				"show_condition": true,
				"show_map": false,
				"listing_fee": 0,
				"base_listing_price": 0,
				"icon": "mobile-phones"
			},
	]
}

GET/category/:id

Category

Get category.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Request

GET
/category/:id
curl -X GET https://api.olx.ba/category/:id \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": {
		"id": 23,
		"name": "Stanovi",
		"name_singular": "Stanovi",
		"slug": "stanovi",
		"parent_id": 2,
		"order": 100,
		"top_category": false,
		"highlighted": false,
		"shipping_available": false,
		"sensitive_content": false,
		"post_option": null,
		"show_price": true,
		"show_brand": false,
		"brand_required": false,
		"model_required": false,
		"has_models": false,
		"show_condition": true,
		"show_map": true,
		"listing_fee": 50,
		"base_listing_price": 14,
		"icon": ""
	}
}

GET/categories/:id/attributes

Category attributes

Get category attributes.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Request

GET
/categories/:id/attributes
curl -X GET https://api.olx.ba/categories/:id/attributes \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": [
		    {
			"id": 901,
			"type": "string",
			"name": "broj-vrata",
			"input_type": "select",
			"display_name": "Broj vrata",
			"options": [
				"2\/3",
				"4\/5"
			],
			"rank": 0,
			"order": 1,
			"required": true,
			"highlighted": false
			},
			{
			"id": 7,
			"type": "string",
			"name": "gorivo",
			"input_type": "select",
			"display_name": "Gorivo",
			"options": [
				"Dizel",
				"Benzin",
				"Plin",
				"Hibrid",
				"Elektro"
			],
			"rank": 0,
			"order": 1,
			"required": true,
			"highlighted": false
			},
	]
}


GET/categories/:id/brands

Category brands

Get category brands.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Request

GET
/categories/:id/brands
curl -X GET https://api.olx.ba/categories/:id/brands \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": [
		{
			"id": 3,
			"name": "Alfa Romeo",
			"slug": "alfa-romeo"
		},
		{
			"id": 7,
			"name": "Audi",
			"slug": "audi"
		},
		{
			"id": 11,
			"name": "BMW",
			"slug": "bmw"
		},
		{
			"id": 20,
			"name": "Citroen",
			"slug": "citroen"
		},
	]
}


GET/categories/:id/brands/:brand_id/models

Category models

Get models.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Request

GET
/categories/:id/brands/:id_brand/models
curl -X GET https://api.olx.ba/categories/:id/brands/:id_brand/models \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": [
		{
			"id": 72,
			"name": "A1",
			"slug": "a1"
		},
		{
			"id": 73,
			"name": "A2",
			"slug": "a2"
		},
		{
			"id": 74,
			"name": "A3",
			"slug": "a3"
		},
		{
			"id": 75,
			"name": "A4",
			"slug": "a4"
		},
	]
}


GET/categories/suggest

Category suggestion

Suggest category by listing title.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Attributes

  • Name
    keyword
    Type
    string
    Description

    Listing title.

Request

GET
/categories/suggest?keyword=golf
curl -X GET https://api.olx.ba/categories/suggest?keyword=golf \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

{
	"data": [
		{
			"id": 18,
			"count": 23216,
			"name": "Automobili",
			"parent_categories": [
				"Vozila"
			]
			},
	]
}


GET/categories/find?name=felge

Category find

Get category attributes.

Headers

  • Name
    Content-Type
    Type
    string
    Description

    application/json

  • Name
    Authorization
    Type
    string
    Description

    Beare <token>

Attributes

  • Name
    name
    Type
    string
    Description

    Category name.

Request

GET
/categories/find?name=felge
curl -X GET https://api.olx.ba/categories/find?name=felge \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer {token}" \

Response

[
	{
		"id": 974,
		"name": "Felge",
		"path": "Vozila > Dijelovi i oprema > Za bicikle > Felge"
	},
	{
		"id": 2158,
		"name": "Gume i felge za traktore",
		"path": "Biznis i Industrija > Poljoprivreda > Dijelovi za traktore i motokultivatore > Gume i felge za traktore"
	},
	{
		"id": 937,
		"name": "Felge",
		"path": "Vozila > Dijelovi i oprema > Za automobile > Felge"
	}
]