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

API Facebook Маркетплейс

POST

Состояние API

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

Просматривайте карточки товаров Facebook Marketplace по keyword в одном городе. Получайте цену, валюту, город, штат, состояние, изображение и время публикации. location принимает слаг города, например nyc (это значение используется по умолчанию), а не точный адрес. Наличие не подтверждается.

Facebook Marketplace ищет карточки товаров по keyword в одном городе Marketplace и возвращает для каждой карточки заголовок в name, price и currency, city, состояние товара в condition, основное изображение, время публикации и ссылку. Так видно, что люди продают поблизости и по каким ценам. Перепродавцы, ценовые аналитики и местные ритейлеры используют это, чтобы исследовать цены на подержанные товары, оценивать объём местного предложения товара или сравнивать его цены в разных городах.

Город задаётся в location: это слаг города из ссылок Marketplace, например nyc, а не почтовый адрес; если параметр не указан, поиск идёт в nyc. В keyword можно также передать полный URL поиска Marketplace: тогда действуют настройки этого URL, а location игнорируется. price — это число без валюты, поэтому смотрите currency в той же записи и учитывайте, что city приходит на языке платформы, без нормализации.

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

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Facebook Маркетплейс (facebook/marketplace).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: facebook и action: marketplace, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Поисковый запрос для разных эндпоинтов платформы. В search ищет публичные публикации; в ads принимает ключевые слова рекламы или прямые URL Ad Library и страниц.
- Необязательные параметры:
  - location: Идентификатор города в пути для marketplace, например nyc (по умолчанию nyc). Произвольные адреса не принимаются. Если keyword содержит полный URL Marketplace, приоритет у этого URL, а location игнорируется.
  - limit: Максимальное число записей в этом вызове, целое число от 1 до 200. Если параметр не указан, применяется значение по умолчанию; вызов может вернуть меньше записей. (по умолчанию: 20)
- Возвращает список записей. Основные поля каждой записи: id, url, name, price, currency, city, state, condition, image_url, posted_at.
- Пример тела запроса:
{
  "platform": "facebook",
  "action": "marketplace",
  "params": {
    "keyword": "coffee"
  }
}
- Цена: $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ДаfacebookИдентификатор платформы, фиксированное значение.
actionbodystringДаmarketplaceИдентификатор возможности, фиксированное значение.
keywordbody.paramsstringДа-Поисковый запрос для разных эндпоинтов платформы. В search ищет публичные публикации; в ads принимает ключевые слова рекламы или прямые URL Ad Library и страниц; в marketplace принимает поисковые запросы по товарам или полные URL поиска Marketplace. Каждое действие обращается к своему набору данных, а не возвращает одни и те же результаты под разными названиями полей.
locationbody.paramsstringНет-Идентификатор города в пути для marketplace, например nyc (по умолчанию nyc). Произвольные адреса не принимаются. Если keyword содержит полный URL Marketplace, приоритет у этого URL, а location игнорируется.
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": "facebook",
  "action": "marketplace",
  "params": {
    "keyword": "coffee"
  }
}'

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

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

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

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

json
{
  "id": "req_…",
  "platform": "facebook",
  "action": "marketplace",
  "results": [
    {
      "id": "•••",
      "url": "https://www.facebook.com/marketplace/item/1397900569221956",
      "name": "Cooper’s Coffee beans",
      "price": "15.00",
      "city": "Brooklyn",
      "state": "NY",
      "image_url": "https://scontent-dfw6-2.xx.fbcdn.net/v/t39.84726-6/796439990_1610692394038073_2004419954068794895_n.jpg?stp=c0.43.261.261a_dst-jpg_p261x260_tt6&_nc_cat=109&ccb=1-7&_nc_sid=92e707&_nc_ohc=U0AcUFUIaGUQ7kNvwGcaEge&_nc_oc=AdqnUNwPMcOnYed1UYcPib3Fv648ODglqYlcUbuIASkyeEsdullVJrXtq3GqU7…",
      "platform": "facebook"
    },
    {
      "id": "•••",
      "url": "https://www.facebook.com/marketplace/item/27339435099065922",
      "name": "Coffee",
      "price": "2.00",
      "city": "Lyndhurst",
      "state": "NJ",
      "image_url": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.84726-6/808176602_1559325292043996_1043941526513956246_n.jpg?stp=c0.43.261.261a_dst-jpg_p261x260_tt6&_nc_cat=103&ccb=1-7&_nc_sid=92e707&_nc_ohc=qlChSijkPf4Q7kNvwHtTFaW&_nc_oc=AdpAWkgxEOQV-FjosxDHaTdJcGMoryZEC3da8NcXYB7Cn0OpUURph8OvIR4M1K…",
      "platform": "facebook"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

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

ПолеЗначение
idУникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
urlСсылка на запись на платформе.
nameНазвание самого объекта для возможностей по аккаунтам, товарам и компаниям.
priceЦена числом без символа валюты; см. currency.
currencyКод валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте.
cityНазвание города на языке платформы в исходном виде.
stateТрактуется так же, как на самой платформе
conditionТрактуется так же, как на самой платформе
image_urlСсылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
posted_atВремя публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).

FAQ

Как выбрать город для поиска?

Передайте в location слаг города из ссылок Marketplace, например nyc: это идентификатор, а не почтовый адрес в свободной форме. Без location Facebook Marketplace ищет в nyc. Если вместо этого передать в keyword полный URL поиска Marketplace, применяются настройки этого URL, а location не используется.

Как читать price и currency?

price — число без символа валюты, а currency содержит код валюты той же карточки. Если price указан, а currency равен null, не делайте предположений о валюте. Приведите карточки к одной валюте, прежде чем сравнивать цены из объявлений в разных городах, и группируйте их по condition, чтобы не усреднять вместе товары разного состояния.

Marketplace — это то же самое, что Facebook Search или Ads?

Нет. Facebook Search, Ads и Marketplace охватывают разные области; это не один и тот же набор результатов с разными полями. Facebook Search возвращает публичные посты по ключевому слову, Facebook Ads — результаты из библиотеки рекламы по ключевому слову объявления или по URL библиотеки рекламы либо страницы, а Facebook Marketplace — карточки товаров по поисковому запросу о товаре или по URL поиска Marketplace.

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

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

Ошибки

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

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

  • Официальные материалы Meta: карточки товаров Marketplace и границы поиска по местоположению ↗

    Архивная документация Meta описывает Marketplace как функцию для размещения и поиска товаров поблизости и различает название, цену и местоположение товара. Это лишь описание таких объектов: из него не следует, что встроенные в интерфейс фильтры или доступность, ранее существовавшая в отдельных регионах, входят в текущие возможности этого эндпоинта.

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