Skip to main content
POST
/
api
/
petsplace
/
products
/
search
/petsplace/products/search
curl --request POST \
  --url https://api.anysite.io/api/petsplace/products/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 500,
  "timeout": 300,
  "keyword": "",
  "sort": "relevance",
  "category": "Kattenbrokken",
  "brand": "Royal Canin",
  "product_group": "Feline Health Nutrition",
  "sub_product_group": "Premium Voeding",
  "health": "Gewicht",
  "flavor": "Kip",
  "clothing_size": "M",
  "weight": "400 g",
  "volume": "250 ml",
  "color": "Zwart",
  "special_type": "20% korting",
  "on_promotion": true,
  "price_min": 1,
  "price_max": 1
}
'
[
  {
    "id": "<string>",
    "@type": "@petsplace_product_search_item",
    "sku": "<string>",
    "gtin13": "<string>",
    "name": "<string>",
    "brand": "<string>",
    "image": "<string>",
    "images": [],
    "price": 123,
    "final_price": 123,
    "sale_price": 123,
    "currency": "<string>",
    "special_type": "<string>",
    "has_promotion": true,
    "promotion_id": "<string>",
    "availability": "<string>",
    "is_in_stock": true,
    "stock": 123,
    "turnover_group": "<string>",
    "sub_turnover_group": "<string>",
    "sub_turnover_group3": "<string>",
    "categories": [],
    "product_group": "<string>",
    "sub_product_group": "<string>",
    "sub_product_group2": "<string>",
    "health": "<string>",
    "flavor": "<string>",
    "packaging": "<string>",
    "size": "<string>",
    "clothing_size": "<string>",
    "weight": "<string>",
    "volume": "<string>",
    "color": "<string>",
    "url": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max number of results to return

Required range: 1 <= x <= 1000
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
keyword
string
default:""

Search keyword. Leave empty to list a category/brand/filter selection without a text query.

Examples:

"kattenvoer"

"royal canin"

"hondenmand"

sort
enum<string>
default:relevance

Result ordering

Available options:
relevance,
price_asc,
price_desc,
title_asc,
title_desc
turnover_group
enum<string> | null

Animal / product domain (top-level navigation group)

Available options:
Hond,
Kat,
Knaagdier,
Vogel,
Vis,
Paard,
Reptiel,
Hengelsport,
Duif,
Boerderijdier,
Buiten(Dieren),
Plant & Zorg,
Werken In De Tuin,
Vijver,
Huis,
Wonen & Leven,
Kleding & Schoeisel,
Leisure,
Events,
Special
category
string | null

Leaf category name

Example:

"Kattenbrokken"

brand
string | null

Brand name

Example:

"Royal Canin"

product_group
string | null

Product group

Example:

"Feline Health Nutrition"

sub_product_group
string | null

Product subgroup

Example:

"Premium Voeding"

health
string | null

Health / purpose attribute

Example:

"Gewicht"

flavor
string | null

Flavor / main ingredient

Example:

"Kip"

packaging
enum<string> | null

Packaging type

Available options:
Alu,
Alukuipje,
Blik,
Cups,
Doos,
Emmer,
Flacon,
Fles,
Folie,
Pak,
Pot,
Pouch,
Sachet,
Spuitbus,
Tetrapack,
Tube,
Verspack,
Versvlees,
Worst,
Zak
size
enum<string> | null

Size class (breed / portion size)

Available options:
Giant,
Large,
Maxi,
Medium,
Mini,
Regular,
Small,
Xlarge,
Xsmall
clothing_size
string | null

Clothing / footwear size

Example:

"M"

weight
string | null

Net weight label

Example:

"400 g"

volume
string | null

Volume label

Example:

"250 ml"

color
string | null

Color

Example:

"Zwart"

special_type
string | null

Promotion type

Example:

"20% korting"

on_promotion
boolean | null

Only products that currently have an active promotion

availability
enum<string> | null

Stock availability

Available options:
in_stock,
out_of_stock
price_min
number | null

Minimum selling price (EUR)

Required range: x >= 0
price_max
number | null

Maximum selling price (EUR)

Required range: x >= 0

Response

Successful Response

id
string
required
@type
string
default:@petsplace_product_search_item
sku
string | null
gtin13
string | null
name
string | null
brand
string | null
image
string | null
images
string[]
price
number | null
final_price
number | null
sale_price
number | null
currency
string | null
special_type
string | null
has_promotion
boolean | null
promotion_id
string | null
availability
string | null
is_in_stock
boolean | null
stock
integer | null
turnover_group
string | null
sub_turnover_group
string | null
sub_turnover_group3
string | null
categories
string[]
product_group
string | null
sub_product_group
string | null
sub_product_group2
string | null
health
string | null
flavor
string | null
packaging
string | null
size
string | null
clothing_size
string | null
weight
string | null
volume
string | null
color
string | null
url
string | null