Слова из заголовка или описания. Пиши по-немецки, по-французски или по-итальянски, либо названием модели.
Вид
Текст
Как писать
строка
Длина
до 100 знаков
Пример
Что значит
iphone 13
iPhone 13
velo
велосипеды по-французски
Категория category
Выбери подраздел или раздел целиком.
Вид
Разделы
Как писать
код или список кодов
Сколько выбрать
до 20
Подразделы
GET /v1/platforms/ricardo/filters/category
Город или индекс place
Город или почтовый индекс в Швейцарии. Радиус вокруг него выбирается отдельно.
Вид
Место
Как писать
строка с кодом места
Поиск места
GET /v1/platforms/ricardo/places?q={text}
Пример
Что значит
Zürich
вокруг Цюриха
1201
вокруг индекса 1201 в Женеве
Радиус radius
Сколько километров вокруг города или индекса. Без места не действует.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
20 20 км
7 вариантов
Код
Название
0
только этот индекс
2
2 км
5
5 км
10
10 км
20
20 км
35
35 км
50
50 км
Цена price
Цена в швейцарских франках. У аукциона считается текущая ставка.
Вид
Диапазон
Как писать
[от, до] или строка «от-до»
Пределы
от 0 до 10000000, CHF
Пример
Что значит
10-500
от 10 до 500 франков
100-
от 100 франков
-50
до 50 франков
Как продают offer
Аукцион: цену решают ставки. Купить сразу: фиксированная цена. Объявления с обоими способами попадают в оба варианта.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
any любой
3 варианта
Код
Название
any
любой
auction
🔨 аукцион
buynow
🛒 купить сразу
Состояние condition
Состояние вещи по словам продавца. Можно отметить несколько, пусто значит любое.
Вид
Несколько вариантов
Как писать
список кодов
5 вариантов
Код
Название
1
✨ Как новое
2
📦 Новое в упаковке
8
👍 Б/у
16
🔧 Неисправное
32
🏺 Антиквариат
Кто продаёт seller_type
Частник или фирма, как продавец записан на площадке.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
any все
3 варианта
Код
Название
any
все
private
👤 частники
business
🏢 фирмы
Доставка delivery
Бесплатная доставка за счёт продавца или самовывоз.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
any любая
3 варианта
Код
Название
any
любая
free
бесплатная доставка
pickup
можно забрать самому
Дата публикации published
Только объявления за выбранное время. Поднятые продавцом старые могут попасть тоже. Короткие окна нужны для слежения: «за 5 минут» присылает только свежее.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
24h за 24 часа
11 вариантов
Код
Название
5m
за 5 минут
15m
за 15 минут
30m
за 30 минут
1h
за 1 час
3h
за 3 часа
6h
за 6 часов
24h
за 24 часа
3d
за 3 дня
7d
за 7 дней
30d
за 30 дней
any
любая
Сортировка sort
Порядок объявлений в файле. «Скоро закончатся» нужно для аукционов. Слежение всегда идёт от новых, порядок там не важен.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
new сначала новые
6 вариантов
Код
Название
new
сначала новые
ending
скоро закончатся
cheap
сначала дешёвые
expensive
сначала дорогие
bids
больше ставок
match
по совпадению
Макс. объявлений у продавца ⚠️seller_ads
Не больше стольких объявлений у продавца. Так отсеиваются магазины и перекупы.
Вид
Число
Как писать
число
Пределы
от 0 до 100000
Пример
Что значит
1
только продавцы с одним объявлением
5
не больше 5 объявлений
Рейтинг продавца от ⚠️seller_rating
Не меньше стольких процентов положительных оценок у продавца.
Вид
Число
Как писать
число
Пределы
от 0 до 100
Пример
Что значит
98
от 98 % положительных
База продавцов base
🆕 Только новые продавцы: придут те, кого ты ещё не получал, по одному объявлению. 1️⃣ Один раз за запуск: по одному объявлению от продавца, прошлые продавцы возможны. 👥 Все продавцы: без отсева.
Вид
Один вариант
Как писать
строка с кодом
По умолчанию
new 🆕 только новые продавцы
3 варианта
Код
Название
new
🆕 только новые продавцы
once
1️⃣ один раз за запуск
all
👥 все продавцы
Почта продавца email
✅ Проверенная: только адреса, которые у Gmail существуют. Нет такой, в карточке «Почта не нашлась». Любая, без проверки: все угаданные адреса, часть может не существовать. Не нужна: без почты.