Skip to main content
POST
/
api
/
kleinanzeigen
/
listings
/
search
/kleinanzeigen/listings/search
curl --request POST \
  --url https://api.anysite.io/api/kleinanzeigen/listings/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "keyword": "<string>",
  "count": 2,
  "timeout": 300,
  "category_id": "217",
  "min_price": 1,
  "max_price": 1,
  "buy_now": false,
  "sort": "newest"
}
'
[
  {
    "id": "<string>",
    "url": "<string>",
    "@type": "@kleinanzeigen_ad_card",
    "title": "<string>",
    "price": 123,
    "currency": "EUR",
    "is_negotiable": false,
    "is_free": false,
    "description": "<string>",
    "postal_code": "<string>",
    "state": "<string>",
    "city": "<string>",
    "posted_at": "<string>",
    "shipping_available": false,
    "image": "<string>",
    "image_count": 123
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
keyword
string
required

Search keyword

Minimum string length: 1
Examples:

"fahrrad"

"iphone 13"

count
integer
required

Max number of listings to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
category_id
string | null

Category ID to scope the search

Example:

"217"

min_price
number | null

Minimum price in EUR

Required range: x >= 0
max_price
number | null

Maximum price in EUR

Required range: x >= 0
condition
enum<string> | null

Filter by item condition

Available options:
new_with_tag,
new,
like_new,
good,
ok,
defect
offer_type
enum<string> | null

Offers (for sale) or wanted ads

Available options:
offer,
wanted
seller_type
enum<string> | null

Private or commercial sellers

Available options:
private,
commercial
shipping
enum<string> | null

Shipping available or pickup only

Available options:
shipping,
pickup
carrier
enum<string> | null

Filter by shipping carrier

Available options:
dhl,
hermes
buy_now
boolean
default:false

Only listings with instant Buy Now enabled

sort
enum<string>
default:newest

Result ordering

Available options:
newest,
price_asc,
price_desc,
distance

Response

Successful Response

id
string
required
url
string
required
@type
string
default:@kleinanzeigen_ad_card
title
string | null
price
number | null
currency
string
default:EUR
is_negotiable
boolean
default:false
is_free
boolean
default:false
description
string | null
postal_code
string | null
state
string | null
city
string | null
posted_at
string | null
shipping_available
boolean
default:false
image
string | null
image_count
integer | null