Skip to main content
POST
Kleinanzeigen listings search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keyword
string
required

Search term. e.g. fahrrad

max_items
integer
default:25

Max items (up to 500)

Required range: 1 <= x <= 500
start_page
integer
default:1

Starting page

Required range: x >= 1
sort
enum<string>

Sort by. Options: newest = Newest, price_asc = Price: low to high, price_desc = Price: high to low, distance = Distance

Available options:
newest,
price_asc,
price_desc,
distance
condition
enum<string>

Condition. Options: new_with_tag = New with tag, new = New, like_new = Like new, good = Good, ok = OK, defect = Defective

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

Offer type. Options: offer = Offers (for sale), wanted = Wanted ads

Available options:
offer,
wanted
seller_type
enum<string>

Seller type. Options: private = Private, commercial = Commercial

Available options:
private,
commercial
shipping
enum<string>

Shipping. Options: shipping = Shipping available, pickup = Pickup only

Available options:
shipping,
pickup
carrier
enum<string>

Carrier. Options: dhl = DHL, hermes = Hermes

Available options:
dhl,
hermes
min_price
number

Min price (EUR)

Required range: x >= 0
max_price
number

Max price (EUR)

Required range: x >= 0
category_id
string

Category ID. e.g. e.g. 217

buy_now
boolean

Buy Now only

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

keyword
string
max_items
integer
start_page
integer
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.