Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Craigslist Поиск

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Ищите объявления Craigslist в выбранном городе и разделе: заголовок, цена, местоположение, дата, координаты, изображения и указанные контакты каждого объявления. Несмотря на название, country выбирает сайт города, например newyork или sfbay, а при нераспознанном значении region по умолчанию выбирается Нью-Йорк.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Craigslist Поиск (craigslist/search).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: craigslist и action: search, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Задаёт поисковый запрос для объявлений Craigslist, например bicycle. Результаты зависят от выбранной категории, поэтому один и тот же запрос может искать товары, жильё или вакансии.
- Необязательные параметры:
  - category: Задаёт слаг категории объявлений: for_sale (по умолчанию), cars_trucks, electronics, furniture, housing_apartments_houses, housing_rooms_shares, housing_sublets_temporary, jobs, gigs, resumes, services, community или eve… (допустимые значения: cars_trucks / community / electronics / events / for_sale / furniture / gigs / housing_apartments_houses)
  - country: Выбирает поддомен целевого города, а не код страны. Принимает значения из схемы, например newyork, sfbay или toronto. Если параметр указан, он переопределяет поддомен, выбранный через region или location. (допустимые значения: anchorage / atlanta / austin / baltimore / boston / calgary / charlotte / chicago)
  - location: Резервное значение для region: учитывается, только если region не указан. Соответствует поддомену города Craigslist, а не адресу, почтовому индексу или географическим координатам.
  - max_price: Задаёт максимальную цену объявления для выбранного поддомена города и категории. Используется вместе с min_price; валюта и периодичность оплаты зависят от конкретного объявления.
  - min_price: Задаёт минимальную цену объявления для выбранного поддомена города и категории. Параметр не обозначает стоимость запросов к API.
  - region: Задаёт слаг поддомена города, например newyork, sfbay или toronto. Принимает точные значения из списка или распространённые псевдонимы, такие как nyc, la, dc и sanfrancisco.
  - sort: Сортирует результаты по дате публикации (newest), по возрастанию цены (price_asc) или по релевантности (relevance); по умолчанию используется дата публикации. (допустимые значения: newest / price_asc / relevance)
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 200. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: id, url, title, text, price, currency, category, location, posted_at, lat, lng, emails; всего полей: 14, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=craigslist.
- Пример тела запроса:
{
  "platform": "craigslist",
  "action": "search",
  "params": {
    "keyword": "bicycle"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаcraigslistИдентификатор платформы, фиксированное значение.
actionbodystringДаsearchИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Задаёт поисковый запрос для объявлений Craigslist, например bicycle. Результаты зависят от выбранной категории, поэтому один и тот же запрос может искать товары, жильё или вакансии.
categorybody.paramsstring (enum)Нет-Задаёт слаг категории объявлений: 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_temporaryjobsresumesservices
countrybody.paramsstring (enum)Нет-Выбирает поддомен целевого города, а не код страны. Принимает значения из схемы, например newyork, sfbay или toronto. Если параметр указан, он переопределяет поддомен, выбранный через region или location.Допустимые значенияanchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondc
locationbody.paramsstringНет-Резервное значение для region: учитывается, только если region не указан. Соответствует поддомену города Craigslist, а не адресу, почтовому индексу или географическим координатам.
max_pricebody.paramsnumberНет-Задаёт максимальную цену объявления для выбранного поддомена города и категории. Используется вместе с min_price; валюта и периодичность оплаты зависят от конкретного объявления. Фильтрация работает с целыми числами: дробные значения округляются вверх (145.98 становится 146).
min_pricebody.paramsnumberНет-Задаёт минимальную цену объявления для выбранного поддомена города и категории. Параметр не обозначает стоимость запросов к API; смысл цены зависит от категории (например, это может быть цена перепродаваемых товаров или арендная плата за жильё). Фильтрация работает с целыми числами: дробные значения округляются вниз (39.81 становится 39).
regionbody.paramsstringНет-Задаёт слаг поддомена города, например newyork, sfbay или toronto. Принимает точные значения из списка или распространённые псевдонимы, такие как nyc, la, dc и sanfrancisco. Нераспознанные значения заменяются на newyork, поэтому проверяйте возвращаемое местоположение, а не исходите из того, что переданное значение было использовано.
sortbody.paramsstring (enum)Нет-Сортирует результаты по дате публикации (newest), по возрастанию цены (price_asc) или по релевантности (relevance); по умолчанию используется дата публикации. Сортировка по репутации продавца или объёму сделок не поддерживается.Допустимые значенияnewestprice_ascrelevance
limitbody.paramsinteger (1–200)Нет20Максимальное число записей в этом вызове, целое число от 1 до 200. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. При значениях выше максимума эндпоинт возвращает ошибку 422 до списания средств.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "craigslist",
  "action": "search",
  "params": {
    "keyword": "bicycle"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json
{
  "id": "req_…",
  "platform": "craigslist",
  "action": "search",
  "results": [
    {
      "id": "•••",
      "url": "https://www.craigslist.org/view/d/commack-24-speed-bike-hard-lady-cruz/h4HVcd5nzs8KyR3HVN9TZG",
      "title": "24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Disc 14”frame",
      "text": "Selling 24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Bicycle\n700 x 35C tires, 14 inch frame, trigger shifters, Suspension seat, Front Suspension with lockouts, Mechanical DISC Brakes, water bottle holder, Adjustable handle bars for a more comfort fit, under seat compa…",
      "price": 230,
      "currency": "USD",
      "category": "For Sale",
      "location": "Commack/Western Suffolk",
      "posted_at": "2026-09-13T04:19:38-04:00",
      "lat": 40.843,
      "lng": -73.2799,
      "images": [
        "https://images.craigslist.org/00N0N_9Zg27TVO3x4_0jm0ew_600x450.jpg",
        "https://images.craigslist.org/00707_hLl3WR8t1Kp_0jm0ew_600x450.jpg",
        "https://images.craigslist.org/00l0l_9fmzO7RF18k_0jm0ew_600x450.jpg"
      ],
      "platform": "craigslist"
    },
    {
      "id": "•••",
      "url": "https://www.craigslist.org/view/d/commack-24-speed-bike-hard-lady-cruz/hZcuH7RbcmTr6Q1VoiiEYd",
      "title": "24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Disc 14”frame",
      "text": "Selling 24 Speed BIKE HARD LADY CRUZ Ultra Light StepThru Hybrid Bicycle\n700 x 35C tires, 14 inch frame, trigger shifters, Suspension seat, Front Suspension with lockouts, Mechanical DISC Brakes, water bottle holder, Adjustable handle bars for a more comfort fit, under seat compa…",
      "price": 230,
      "currency": "USD",
      "category": "For Sale",
      "location": "Commack/Western Suffolk",
      "posted_at": "2026-09-13T03:44:18-04:00",
      "lat": 40.843,
      "lng": -73.2799,
      "images": [
        "https://images.craigslist.org/00Q0Q_1L0TRDLmTUr_0CI0t2_600x450.jpg",
        "https://images.craigslist.org/00o0o_jzfT4Xvtn1Q_0CI0t2_600x450.jpg",
        "https://images.craigslist.org/00V0V_ehTbYzbjHWi_0CI0t2_600x450.jpg"
      ],
      "platform": "craigslist"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
titleЗаголовок. null, если на платформе нет заголовков (например, у текстовых постов).
textОсновной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы).
priceЦена числом без символа валюты; см. currency.
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
categoryНазвание категории во внутренней классификации платформы. Категории разных платформ не унифицированы.
locationОписание местоположения передаётся как есть; формат зависит от платформы.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
latТрактуется так же, как на самой платформе
lngТрактуется так же, как на самой платформе
emailsКонтактные адреса электронной почты (у записи их может быть несколько) передаются как есть, без дубликатов.
phonesТрактуется так же, как на самой платформе
imagesМассив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • Craigslist: выбор местоположения отличается от поиска по городским поддоменам ↗

    Craigslist отделяет выбор географического местоположения от обработки поискового запроса и предлагает официальные инструменты уточнения по карте и ZIP-коду. В этом действии параметры country / region принимают только формат городского поддомена, описанный выше, и не добавляют фильтрацию по почтовому индексу или радиусу.

    Проверено 2026-09-04

  • Craigslist: как категории каталога сочетаются с текстовым поиском ↗

    Согласно официальным рекомендациям Craigslist, сначала нужно выбрать категорию в своём регионе, а затем уточнять результаты текстовым запросом. Параметр category в этом действии принимает нейтральные значения, перечисленные выше, и не принимает напрямую официальные коды категорий платформы или другие фильтры сайта.

    Проверено 2026-09-04