Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Craigslist: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите объявления Craigslist в выбранном городе и разделе: заголовок, цена, местоположение, дата, координаты, изображения и указанные контакты каждого объявления. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Craigslist?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите объявления Craigslist в выбранном городе и разделе: заголовок, цена, местоположение, дата, координаты, изображения и указанные контакты каждого объявления. Несмотря на название, | keyword | category, country, location, max_price, min_price, region, sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · price · currency · category · location · posted_at · lat · lng · emails · phones · images · platform |
Что означают параметры действия search в API Craigslist?
Ищите объявления Craigslist в выбранном городе и разделе: заголовок, цена, местоположение, дата, координаты, изображения и указанные контакты каждого объявления. Несмотря на название, country выбирает сайт города, например newyork или sfbay, а при нераспознанном значении region по умолчанию выбирается Нью-Йорк.
keywordОбязательный- Задаёт поисковый запрос для объявлений Craigslist, например bicycle. Результаты зависят от выбранной категории, поэтому один и тот же запрос может искать товары, жильё или вакансии.
categoryНеобязательный- Задаёт слаг категории объявлений: for_sale (по умолчанию), cars_trucks, electronics, furniture, housing_apartments_houses, housing_rooms_shares, housing_sublets_temporary, jobs, gigs, resumes, services, community или events.Допустимые значения:
cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservicesCraigslist: как категории каталога сочетаются с текстовым поиском — Согласно официальным рекомендациям Craigslist, сначала нужно выбрать категорию в своём регионе, а затем уточнять результаты текстовым запросом. Параметр category в этом действии принимает нейтральные значения, перечисленные выше, и не принимает напрямую официальные коды категорий платформы или другие фильтры сайта. · Проверено countryНеобязательный- Выбирает поддомен целевого города, а не код страны. Принимает значения из схемы, например newyork, sfbay или toronto. Если параметр указан, он переопределяет поддомен, выбранный через region или location.Допустимые значения:
anchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondcCraigslist: выбор местоположения отличается от поиска по городским поддоменам — Craigslist отделяет выбор географического местоположения от обработки поискового запроса и предлагает официальные инструменты уточнения по карте и ZIP-коду. В этом действии параметры country / region принимают только формат городского поддомена, описанный выше, и не добавляют фильтрацию по почтовому индексу или радиусу. · Проверено locationНеобязательный- Резервное значение для region: учитывается, только если region не указан. Соответствует поддомену города Craigslist, а не адресу, почтовому индексу или географическим координатам.
max_priceНеобязательный- Задаёт максимальную цену объявления для выбранного поддомена города и категории. Используется вместе с min_price; валюта и периодичность оплаты зависят от конкретного объявления. Фильтрация работает с целыми числами: дробные значения округляются вверх (145.98 становится 146).
min_priceНеобязательный- Задаёт минимальную цену объявления для выбранного поддомена города и категории. Параметр не обозначает стоимость запросов к API; смысл цены зависит от категории (например, это может быть цена перепродаваемых товаров или арендная плата за жильё). Фильтрация работает с целыми числами: дробные значения округляются вниз (39.81 становится 39).
regionНеобязательный- Задаёт слаг поддомена города, например newyork, sfbay или toronto. Принимает точные значения из списка или распространённые псевдонимы, такие как nyc, la, dc и sanfrancisco. Нераспознанные значения заменяются на newyork, поэтому проверяйте возвращаемое местоположение, а не исходите из того, что переданное значение было использовано.
sortНеобязательный- Сортирует результаты по дате публикации (newest), по возрастанию цены (price_asc) или по релевантности (relevance); по умолчанию используется дата публикации. Сортировка по репутации продавца или объёму сделок не поддерживается.Допустимые значения:
newestprice_ascrelevance
Как использовать API Craigslist
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"craigslist","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Craigslist
Какие данные можно получить через API Craigslist?
Укажите в platform значение craigslist. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям Craigslist; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Craigslist?
Задаёт поисковый запрос для объявлений Craigslist, например bicycle. Результаты зависят от выбранной категории, поэтому один и тот же запрос может искать товары, жильё или вакансии. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Craigslist?
Объявленная схема включает title, text, price и currency. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Craigslist возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.