/bol/categories/products

curl --request POST \
  --url https://api.anysite.io/api/bol/categories/products \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "category": "<string>",
  "count": 2,
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@bol_search_product",
    "name": "<string>",
    "url": "<string>",
    "image": "<string>",
    "brand": "<string>",
    "brand_url": "<string>",
    "price": 123,
    "list_price": 123,
    "condition": "<string>",
    "delivery": "<string>",
    "delivered_within_48h": true,
    "rating": 123,
    "review_count": 123,
    "categories": [],
    "is_sponsored": false
  }
]

Bol

/bol/categories/products

List Bol.com products within a category by category id (or category URL). Returns product cards with name, brand, image, price, list price, condition, delivery info, rating, review count, category hierarchy, product url and a sponsored flag.

Price: 10 credits per 20 results

💡 AI Hint: List products in a Bol.com category by numeric category id (compound ids like 8299+1336 are supported) or a category URL. Each result has id, name, url, image, brand/brand_url, price, list_price (original price before discount, when present), condition (New/Used/Refurbished), delivery (delivery description), delivered_within_48h, rating, review_count, categories (category hierarchy) and is_sponsored.

⚠️ Common errors: 412: Category not found (well-formed but nonexistent category id)

POST

api

bol

categories

products

/bol/categories/products

curl --request POST \
  --url https://api.anysite.io/api/bol/categories/products \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "category": "<string>",
  "count": 2,
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@bol_search_product",
    "name": "<string>",
    "url": "<string>",
    "image": "<string>",
    "brand": "<string>",
    "brand_url": "<string>",
    "price": 123,
    "list_price": 123,
    "condition": "<string>",
    "delivery": "<string>",
    "delivered_within_48h": true,
    "rating": 123,
    "review_count": 123,
    "categories": [],
    "is_sponsored": false
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

Response

Successful Response

string

required

@type

string

default:@bol_search_product

name

string | null

url

string | null

image

string | null

brand

string | null

brand_url

string | null

price

number | null

list_price

number | null

condition

string | null

delivery

string | null

delivered_within_48h

boolean | null

rating

number | null

review_count

integer | null