Доступность платформы
- Состояние за 24 ч
- 87%
За последние 30 дней
Доступные возможности
Все действия Facebook: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите посты Facebook по keyword и получайте текст, автора, лайки, комментарии, репосты и время публикации каждого поста, с необязательным диапазоном дат. | $16 за 1 000 запросовКаждые 10 записей считаются одним вызовом API | Работает стабильно · состояние 100% |
Сведенияprofile | Получите страницу Facebook или публичный профиль по url. | $2.78 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получайте посты страницы или аккаунта Facebook по url: текст, автор, время публикации и число лайков, комментариев и репостов. | $2.78 за 1 000 запросов | Норма |
Сведения о постеpost | Получите один пост Facebook по url: текст, автора, время публикации и число лайков, комментариев и репостов. | $1.39 за 1 000 запросов | Доступно · состояние 83% |
Комментарииcomments | Получайте комментарии к посту Facebook по url. | $2.78 за 1 000 запросов | Норма |
Подписчикиfollowers | Проверяйте число подписчиков, подписок, постов и лайков аккаунта или страницы Facebook по username. | $1.39 за 1 000 запросов | Норма |
Рекламаads | Находите объявления в Facebook Ad Library по keyword или URL Ad Library. | $1.39 за 1 000 запросов | Норма |
Публикации группыgroup_posts | Читайте посты группы Facebook по url или идентификатору группы. | $1.39 за 1 000 запросов | Норма |
Маркетплейсmarketplace | Просматривайте карточки товаров Facebook Marketplace по keyword в одном городе. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Собирайте рекомендации и отзывы со страницы Facebook по url: текст, рекомендует автор или нет, оценку, если есть, автора и время публикации. | $1.39 за 1 000 запросов | Норма |
Поиск рекламодателейadvertiser_search | Находите страницы Facebook, которые размещают рекламу под названием бренда или рекламодателя в Ad Library, до 15 за вызов. | $0.88 за 1 000 запросов | Норма |
Сведения о рекламном объявленииad_detail | Откройте одно объявление в Facebook Ad Library по ссылке или Library ID. | $0.96 за 1 000 запросов | Норма |
Поиск мероприятийevents_search | Ищите публичные мероприятия Facebook по keyword, например music festival. | $0.96 за 1 000 запросов | Норма |
Сведения о карточке товара на Marketplacemarketplace_item | Получите одну карточку товара Facebook Marketplace по ссылке или числовому ID: название, описание, цену и исходную цену, валюту, состояние, характеристики товара, местоположение с координатами, время публикации, флаги «продано» и «в ожидании», варианты отправки и доставки, фото, а также имя продавца, рейтинг, число оценок и дату регистрации. | $0.96 за 1 000 запросов | Норма |
Мероприятия страницыpage_events | Получайте список мероприятий публичной страницы Facebook, предстоящих и прошедших, по ссылке на страницу. | $0.96 за 1 000 запросов | Норма |
Расшифровки видеопостовpost_transcript | Преобразуйте речь из публичного видео, Reel или видеопоста Facebook в текст по ссылке. | $0.96 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Facebook?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите посты Facebook по | keyword | content_type, since, until | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $16 за 1 000 запросовКаждые 10 записей считаются одним вызовом API | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
profileСведения Получите страницу Facebook или публичный профиль по | url | — | Режим выдачи: Async | — | $2.78 за 1 000 запросов | id · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform |
user_postsПосты пользователя Получайте посты страницы или аккаунта Facebook по | url | — | Режим выдачи: Async | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $2.78 за 1 000 запросов | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
postСведения о посте Получите один пост Facebook по | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · text · author_name · author_username · author_id · author_url · author_avatar_url · media · reactions · view_count · link · group_name · is_paid_partnership · like_count · comment_count · share_count · posted_at · platform |
commentsКомментарии Получайте комментарии к посту Facebook по | url | — | Режим выдачи: Async | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $2.78 за 1 000 запросов | id · text · author_name · author_username · depth · reply_to_id · comment_url · author_id · author_url · like_count · reply_count · posted_at · platform |
followersПодписчики Проверяйте число подписчиков, подписок, постов и лайков аккаунта или страницы Facebook по | username | channel | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
adsРеклама Находите объявления в Facebook Ad Library по | keyword | country, status | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform |
group_postsПубликации группы Читайте посты группы Facebook по | url | sort | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform |
marketplaceМаркетплейс Просматривайте карточки товаров Facebook Marketplace по | keyword | location | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · name · price · currency · city · state · condition · image_url · posted_at · platform |
reviewsОтзывы Собирайте рекомендации и отзывы со страницы Facebook по | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform |
advertiser_searchПоиск рекламодателей Находите страницы Facebook, которые размещают рекламу под названием бренда или рекламодателя в Ad Library, до 15 за вызов. Для каждой страницы есть ID, название, имя пользователя, категория, флаг верификации, лайки страницы и связанный аккаунт Instagram с числом подписчиков. При поиске nike первой идёт Nike (Page ID 15087023444). Пагинации нет. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=15, maxLimit=15. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. Можно передать большее значение limit, но оно будет ограничено значением 15. | $0.88 за 1 000 запросов | id · name · username · url · category · avatar_url · page_like_count · is_verified · instagram_username · instagram_follower_count · instagram_verified · country · platform |
ad_detailСведения о рекламном объявлении Откройте одно объявление в Facebook Ad Library по ссылке или Library ID. Узнайте, показывается ли оно сейчас, даты начала и окончания, текст объявления, заголовок, ссылку и призыв к действию, формат показа, площадки размещения, изображения или видео, все варианты креатива, а также Page ID, название, лайки и категории страницы рекламодателя. Расходы, охват и таргетинг в результат не входят. | url | — | Режим выдачи: Sync | — | $0.96 за 1 000 запросов | id · url · is_active · started_at · ended_at · text · title · caption · link_url · link_description · cta_text · display_format · platforms · media · creatives · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · advertiser_avatar_url · advertiser_categories · platform |
events_searchПоиск мероприятий Ищите публичные мероприятия Facebook по | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 5. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.96 за 1 000 запросов | id · url · name · starts_at · date_text · place_name · place_id · is_online · is_past · going_count · interested_count · price_text · image_url · next_page_token · platform |
marketplace_itemСведения о карточке товара на Marketplace Получите одну карточку товара Facebook Marketplace по ссылке или числовому ID: название, описание, цену и исходную цену, валюту, состояние, характеристики товара, местоположение с координатами, время публикации, флаги «продано» и «в ожидании», варианты отправки и доставки, фото, а также имя продавца, рейтинг, число оценок и дату регистрации. | url | — | Режим выдачи: Sync | — | $0.96 за 1 000 запросов | id · url · title · text · price · price_text · original_price_text · currency · condition · attributes · location · latitude · longitude · posted_at · is_sold · is_pending · is_shipping_offered · delivery_types · category_id · image_urls · seller_id · seller_name · seller_rating · seller_rating_count · seller_joined_at · platform |
page_eventsМероприятия страницы Получайте список мероприятий публичной страницы Facebook, предстоящих и прошедших, по ссылке на страницу. Для каждого мероприятия есть название, время начала, место, город, организатор и флаги онлайн-формата, прошедшего и отменённого мероприятия. До 10 на страницу, число варьируется; следующую страницу запрашивайте через | url | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 10. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $0.96 за 1 000 запросов | id · url · name · starts_at · date_text · place_name · city · host_name · is_online · is_past · is_canceled · next_page_token · platform |
post_transcriptРасшифровки видеопостов Преобразуйте речь из публичного видео, Reel или видеопоста Facebook в текст по ссылке. Вы получаете расшифровку и длительность видео в секундах. Для видео без речи | url | — | Режим выдачи: Sync | — | $0.96 за 1 000 запросов | id · url · text · duration_seconds · duration_sec · platform |
Что означают параметры действия search в API Facebook?
Ищите посты Facebook по keyword и получайте текст, автора, лайки, комментарии, репосты и время публикации каждого поста, с необязательным диапазоном дат. content_type сортирует по новизне или популярности, а не фильтрует медиа; личные сообщения не ищутся.
keywordОбязательный- Поисковый запрос для разных эндпоинтов платформы. В search ищет публичные публикации; в ads принимает ключевые слова рекламы или прямые URL Ad Library и страниц; в marketplace принимает поисковые запросы по товарам или полные URL поиска Marketplace. Каждое действие обращается к своему набору данных, а не возвращает одни и те же результаты под разными названиями полей.
content_typeНеобязательный- Сортирует результаты действия search; допустимые значения: latest (новые публикации) или most_popular (популярные публикации). Несмотря на название, content_type задаёт сортировку и не фильтрует по формату медиа, например изображениям или видео.Допустимые значения:
latestmost_popularFacebook: где проходят границы публичных публикаций и публичной информации — Справочные материалы Facebook определяют видимость публикаций с общим доступом, публикаций Страниц и комментариев к публичным публикациям. Это уточняет, к каким объектам относится поиск, но не подтверждает значения ранжирования `content_type` и не означает, что публично видимую информацию разрешено собирать автоматически. · Проверено sinceНеобязательный- Фильтрует публикации в действии search по дате публикации, начиная с этой даты; рекомендуемый формат YYYY-MM-DD. Вместе с until задаёт диапазон дат запроса; не фильтрует время показа рекламы и время создания комментариев.
untilНеобязательный- Фильтрует публикации в действии search по дате публикации до этой даты; рекомендуемый формат YYYY-MM-DD. Вместе с since задаёт диапазон дат запроса; не управляет датой окончания показа рекламы.
Что означают параметры действия profile в API Facebook?
Получите страницу Facebook или публичный профиль по url. В ответе есть категория, описание, лайки, подписчики, значок верификации и контактные данные, если они указаны. Телефон и email — только то, что отображается на странице. Они не подтверждают личность и не дают права на их использование.
urlОбязательный- Целевой URL, соответствующий запрошенному действию. Используйте URL публичных страниц для profile и user_posts, URL публикаций для post и comments, URL страниц групп или идентификаторы групп для group_posts и URL бизнес-страниц для reviews (к нему добавляется /reviews). Произвольные URL Facebook нельзя использовать в разных действиях взаимозаменяемо.Официальные материалы Facebook: публичная видимость профилей Страниц, публикаций и комментариев — Официальная документация Meta описывает общедоступные сведения на Страницах, в профилях, публикациях и комментариях. Это определение видимости не гарантирует, что можно прочитать любой URL, что будет возвращено каждое поле или что для этого эндпоинта получено разрешение Meta на доступ. · ПровереноОфициальная документация Meta: для автоматического сбора данных нужно предварительное разрешение — Meta прямо указывает, что автоматический сбор данных Facebook без предварительного разрешения нарушает её условия, даже если данные общедоступны. Ссылки на авторитетные источники не подтверждают наличия разрешения платформы на сбор или повторное использование данных. · Проверено
Что означают параметры действия user_posts в API Facebook?
Получайте посты страницы или аккаунта Facebook по url: текст, автор, время публикации и число лайков, комментариев и репостов. Результаты не обязательно охватывают всю ленту.
urlОбязательный- Целевой URL, соответствующий запрошенному действию. Используйте URL публичных страниц для profile и user_posts, URL публикаций для post и comments, URL страниц групп или идентификаторы групп для group_posts и URL бизнес-страниц для reviews (к нему добавляется /reviews). Произвольные URL Facebook нельзя использовать в разных действиях взаимозаменяемо.Официальные материалы Facebook: публичная видимость профилей Страниц, публикаций и комментариев — Официальная документация Meta описывает общедоступные сведения на Страницах, в профилях, публикациях и комментариях. Это определение видимости не гарантирует, что можно прочитать любой URL, что будет возвращено каждое поле или что для этого эндпоинта получено разрешение Meta на доступ. · ПровереноОфициальная документация Meta: для автоматического сбора данных нужно предварительное разрешение — Meta прямо указывает, что автоматический сбор данных Facebook без предварительного разрешения нарушает её условия, даже если данные общедоступны. Ссылки на авторитетные источники не подтверждают наличия разрешения платформы на сбор или повторное использование данных. · Проверено
Что означают параметры действия post в API Facebook?
Получите один пост Facebook по url: текст, автора, время публикации и число лайков, комментариев и репостов. Комментарии, подробные данные о реакциях и закрытый контент не включаются. Для ветки комментариев используйте comments.
urlОбязательный- Целевой URL, соответствующий запрошенному действию. Используйте URL публичных страниц для profile и user_posts, URL публикаций для post и comments, URL страниц групп или идентификаторы групп для group_posts и URL бизнес-страниц для reviews (к нему добавляется /reviews). Произвольные URL Facebook нельзя использовать в разных действиях взаимозаменяемо.Официальные материалы Facebook: публичная видимость профилей Страниц, публикаций и комментариев — Официальная документация Meta описывает общедоступные сведения на Страницах, в профилях, публикациях и комментариях. Это определение видимости не гарантирует, что можно прочитать любой URL, что будет возвращено каждое поле или что для этого эндпоинта получено разрешение Meta на доступ. · ПровереноОфициальная документация Meta: для автоматического сбора данных нужно предварительное разрешение — Meta прямо указывает, что автоматический сбор данных Facebook без предварительного разрешения нарушает её условия, даже если данные общедоступны. Ссылки на авторитетные источники не подтверждают наличия разрешения платформы на сбор или повторное использование данных. · Проверено
Что означают параметры действия comments в API Facebook?
Получайте комментарии к посту Facebook по url. У каждого комментария есть автор, ID автора, лайки, число ответов, время публикации и постоянная ссылка. Записи-ответы повторяют ID родительской группы, поэтому восстанавливайте ветки по depth и reply_to_id. Полное дерево не гарантируется.
urlОбязательный- Целевой URL, соответствующий запрошенному действию. Используйте URL публичных страниц для profile и user_posts, URL публикаций для post и comments, URL страниц групп или идентификаторы групп для group_posts и URL бизнес-страниц для reviews (к нему добавляется /reviews). Произвольные URL Facebook нельзя использовать в разных действиях взаимозаменяемо.Официальные материалы Facebook: публичная видимость профилей Страниц, публикаций и комментариев — Официальная документация Meta описывает общедоступные сведения на Страницах, в профилях, публикациях и комментариях. Это определение видимости не гарантирует, что можно прочитать любой URL, что будет возвращено каждое поле или что для этого эндпоинта получено разрешение Meta на доступ. · ПровереноОфициальная документация Meta: для автоматического сбора данных нужно предварительное разрешение — Meta прямо указывает, что автоматический сбор данных Facebook без предварительного разрешения нарушает её условия, даже если данные общедоступны. Ссылки на авторитетные источники не подтверждают наличия разрешения платформы на сбор или повторное использование данных. · Проверено
Что означают параметры действия followers в API Facebook?
Проверяйте число подписчиков, подписок, постов и лайков аккаунта или страницы Facebook по username. Флаг точности указывает, какие значения приблизительны. Возвращаются только итоговые значения, без списка отдельных подписчиков.
usernameОбязательный- Идентификатор аккаунта или страницы Facebook без символа @ для действия followers. Эта возможность возвращает объект с общим числом подписчиков, а не выгрузку профилей отдельных подписчиков или граф связей пользователей.Facebook: подписка на Страницу отличается от отметки «Нравится» — Официальная документация Facebook поясняет, что подписка нужна для получения обновлений Страницы, и описывает различия для Страниц, переходящих с модели «Нравится» на модель подписок. Это позволяет различать `follower_count` и `like_count`, но не означает, что эта платформа может выгружать списки подписчиков. · Проверено
channelНеобязательный- Параметр совместимости для идентификатора аккаунта в действии followers. Если передан username, приоритет у него; в публичных запросах обязательный параметр username всё равно нужен. Это не ID чат-канала.
Что означают параметры действия ads в API Facebook?
Находите объявления в Facebook Ad Library по keyword или URL Ad Library. Получайте текст объявления, призыв к действию, целевую страницу, даты показа, площадки и рекламодателя. Фильтруйте по стране и status. Расходы, показы, таргетинг и конверсии не включаются.
keywordОбязательный- Поисковый запрос для разных эндпоинтов платформы. В search ищет публичные публикации; в ads принимает ключевые слова рекламы или прямые URL Ad Library и страниц; в marketplace принимает поисковые запросы по товарам или полные URL поиска Marketplace. Каждое действие обращается к своему набору данных, а не возвращает одни и те же результаты под разными названиями полей.Официальные материалы Meta: объявления и Страницы как объекты поиска в Библиотеке рекламы — Архивные анонсы Meta описывают поиск рекламы по ключевым словам или Странице и различия в данных о прозрачности между обычной активной рекламой и рекламой на политические и социальные темы, а также требования официального API. Это не означает, что для всей рекламы доступны расходы, показы или полная история: такие поля не предоставляются этим эндпоинтом на постоянной основе. · Проверено
countryНеобязательный- Код страны для запросов по ключевым словам в действии ads, например US (по умолчанию US). При формировании URL запроса значение приводится к верхнему регистру. Если keyword передан как полный URL, приоритет у параметров, встроенных в этот URL, и страна из этого параметра не применяется.
statusНеобязательный- Фильтрует рекламу по статусу; допустимые значения: all (по умолчанию), active (показывается сейчас) или inactive (остановлена). Это статус показа рекламы, а не статус её модерации. Если в keyword передан URL Ad Library, встроенный в него active_status может отличаться от этого параметра; задавайте их согласованно.
Что означают параметры действия group_posts в API Facebook?
Читайте посты группы Facebook по url или идентификатору группы. Получайте текст, автора, время публикации и число лайков, комментариев и репостов. sort выбирает лучшие посты или сортировку по недавней активности. Во втором случае учитывается время последней активности, а не время создания поста. Полный охват не гарантируется.
urlОбязательный- Целевой URL, соответствующий запрошенному действию. Используйте URL публичных страниц для profile и user_posts, URL публикаций для post и comments, URL страниц групп или идентификаторы групп для group_posts и URL бизнес-страниц для reviews (к нему добавляется /reviews). Произвольные URL Facebook нельзя использовать в разных действиях взаимозаменяемо.Официальные материалы Meta: прежний закрытый контент остаётся защищённым, когда группа становится публичной — Официальная документация Meta отмечает, что после перевода закрытой группы в публичную новый контент становится общедоступным, а доступ к контенту и спискам участников за период, когда группа была закрытой, остаётся ограниченным. Поэтому текущий публичный статус группы не гарантирует доступа к прошлым публикациям или полным спискам участников. · ПровереноОфициальная документация Meta: для автоматического сбора данных нужно предварительное разрешение — Meta прямо указывает, что автоматический сбор данных Facebook без предварительного разрешения нарушает её условия, даже если данные общедоступны. Ссылки на авторитетные источники не подтверждают наличия разрешения платформы на сбор или повторное использование данных. · Проверено
sortНеобязательный- Порядок публикаций для group_posts: top (лучшие публикации) или recent (публикации с недавней активностью); если параметр не задан, используется хронологический порядок. Вариант recent основан на активности, а не только на времени создания публикации. Неподдерживаемые строковые значения приводят к хронологическому порядку, а не к ошибке.
Что означают параметры действия marketplace в API Facebook?
Просматривайте карточки товаров Facebook Marketplace по keyword в одном городе. Получайте цену, валюту, город, штат, состояние, изображение и время публикации. location принимает слаг города, например nyc (это значение используется по умолчанию), а не точный адрес. Наличие не подтверждается.
keywordОбязательный- Поисковый запрос для разных эндпоинтов платформы. В search ищет публичные публикации; в ads принимает ключевые слова рекламы или прямые URL Ad Library и страниц; в marketplace принимает поисковые запросы по товарам или полные URL поиска Marketplace. Каждое действие обращается к своему набору данных, а не возвращает одни и те же результаты под разными названиями полей.
locationНеобязательный- Идентификатор города в пути для marketplace, например nyc (по умолчанию nyc). Произвольные адреса не принимаются. Если keyword содержит полный URL Marketplace, приоритет у этого URL, а location игнорируется.Официальные материалы Meta: карточки товаров Marketplace и границы поиска по местоположению — Архивная документация Meta описывает Marketplace как функцию для размещения и поиска товаров поблизости и различает название, цену и местоположение товара. Это лишь описание таких объектов: из него не следует, что встроенные в интерфейс фильтры или доступность, ранее существовавшая в отдельных регионах, входят в текущие возможности этого эндпоинта. · Проверено
Что означают параметры действия reviews в API Facebook?
Собирайте рекомендации и отзывы со страницы Facebook по url: текст, рекомендует автор или нет, оценку, если есть, автора и время публикации. Facebook использует «рекомендую / не рекомендую» вместо звёзд, поэтому отсутствие оценки не отменяет рекомендацию.
urlОбязательный- Целевой URL, соответствующий запрошенному действию. Используйте URL публичных страниц для profile и user_posts, URL публикаций для post и comments, URL страниц групп или идентификаторы групп для group_posts и URL бизнес-страниц для reviews (к нему добавляется /reviews). Произвольные URL Facebook нельзя использовать в разных действиях взаимозаменяемо.Официальная документация Facebook: рекомендации и отзывы о Страницах — Официальная документация поясняет, что рекомендации показываются в разделе «Отзывы» Страницы, и отмечает, что удаление отзывов с нарушениями может изменить рейтинг Страницы. Общий рейтинг Страницы отличается от отдельной рекомендации, поэтому `is_recommended` нельзя автоматически преобразовать в оценку в звёздах. · ПровереноОфициальная документация Meta: для автоматического сбора данных нужно предварительное разрешение — Meta прямо указывает, что автоматический сбор данных Facebook без предварительного разрешения нарушает её условия, даже если данные общедоступны. Ссылки на авторитетные источники не подтверждают наличия разрешения платформы на сбор или повторное использование данных. · Проверено
Что означают параметры действия advertiser_search в API Facebook?
Находите страницы Facebook, которые размещают рекламу под названием бренда или рекламодателя в Ad Library, до 15 за вызов. Для каждой страницы есть ID, название, имя пользователя, категория, флаг верификации, лайки страницы и связанный аккаунт Instagram с числом подписчиков. При поиске nike первой идёт Nike (Page ID 15087023444). Пагинации нет.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Название бренда или рекламодателя, например
nike. Возвращает Страницы, которые размещают рекламу под этим названием в Библиотеке рекламы; каждыйid— это ID Страницы.
Что означают параметры действия ad_detail в API Facebook?
Откройте одно объявление в Facebook Ad Library по ссылке или Library ID. Узнайте, показывается ли оно сейчас, даты начала и окончания, текст объявления, заголовок, ссылку и призыв к действию, формат показа, площадки размещения, изображения или видео, все варианты креатива, а также Page ID, название, лайки и категории страницы рекламодателя. Расходы, охват и таргетинг в результат не входят.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Одно рекламное объявление: ссылка на объявление в Библиотеке рекламы (https://www.facebook.com/ads/library/?id=<Library ID>) или сам числовой ID в Библиотеке рекламы (
idзаписиads).
Что означают параметры действия events_search в API Facebook?
Ищите публичные мероприятия Facebook по keyword, например music festival. Для каждого мероприятия есть название, время начала, дата в том виде, как её показывает Facebook, место проведения, флаг онлайн-формата, отметка о том, прошло ли оно, число отметок «Пойду» и «Интересует», текст с ценой билета, если он отображается, и обложка. Прошедшие мероприятия включаются. Около 5 на страницу; следующую страницу запрашивайте через next_page_token.
keywordОбязательный- Слова для поиска публичных мероприятий, например
music festivalилиyoga Singapore. Прошедшие мероприятия тоже включаются; проверяйтеis_past. page_tokenНеобязательный- Токен страницы для
events_searchиpage_events. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности так, как получили; на последней странице его нет.
Что означают параметры действия marketplace_item в API Facebook?
Получите одну карточку товара Facebook Marketplace по ссылке или числовому ID: название, описание, цену и исходную цену, валюту, состояние, характеристики товара, местоположение с координатами, время публикации, флаги «продано» и «в ожидании», варианты отправки и доставки, фото, а также имя продавца, рейтинг, число оценок и дату регистрации.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Одна карточка товара: ссылка на товар Marketplace (https://www.facebook.com/marketplace/item/<ID>/) или числовой ID товара (
idзаписиmarketplace).
Что означают параметры действия page_events в API Facebook?
Получайте список мероприятий публичной страницы Facebook, предстоящих и прошедших, по ссылке на страницу. Для каждого мероприятия есть название, время начала, место, город, организатор и флаги онлайн-формата, прошедшего и отменённого мероприятия. До 10 на страницу, число варьируется; следующую страницу запрашивайте через next_page_token. Для страницы без мероприятий возвращается пустой список.
urlОбязательный- Ссылка на публичную Страницу, например https://www.facebook.com/brickyardoldtown; подходят и ссылки вида /p/<name>-<ID>.
page_tokenНеобязательный- Токен страницы для
events_searchиpage_events. Для первой страницы не передавайте его, затем передавайтеnext_page_tokenиз предыдущего ответа в точности так, как получили; на последней странице его нет.
Что означают параметры действия post_transcript в API Facebook?
Преобразуйте речь из публичного видео, Reel или видеопоста Facebook в текст по ссылке. Вы получаете расшифровку и длительность видео в секундах. Для видео без речи text не возвращается.
urlОбязательный- Ссылка на публичное видео, Reel или пост с видео, например https://www.facebook.com/reel/<ID>/.
Как использовать API Facebook
- 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":"facebook","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API Facebook
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Как мониторить репутацию на нескольких платформах: сначала определите охват, потом оценивайте рост негатива
Спроектируйте прослеживаемый процесс мониторинга репутации на основе списков целей, идентификаторов комментариев и инкрементальных курсоров; офлайн-примеры показывают дедупликацию и пробелы в сборе данных при сохранении ручной проверки.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API Facebook
Какие данные можно получить через API Facebook?
Укажите в platform значение facebook. В текущем каталоге: поиск, сведения, посты пользователя, сведения о посте, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям Facebook; это не взаимозаменяемые режимы поиска.
Есть ли у Facebook официальный API?
Да. Официальный интерфейс — Graph API от Meta. Чтобы читать публичные посты и комментарии со страниц Facebook, которыми ваше приложение не управляет, нужна функция Page Public Content Access; Meta предоставляет её только после App Review и верификации компании. Хроника конкретного человека доступна только с его разрешения и для ограниченного круга задач.
Официальные источники: «Meta: Page Public Content Access» · «Meta Graph API» · Проверено
Нужен ли аккаунт разработчика Facebook или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Facebook, запрашивать доступ к API Facebook или входить через аккаунт Facebook. Действия возвращают только публичные данные Facebook.
Сколько стоит Facebook API за 1 000 запросов?
От $0.88 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе Facebook?
Поисковый запрос для разных эндпоинтов платформы. В search ищет публичные публикации; в ads принимает ключевые слова рекламы или прямые URL Ad Library и страниц; в marketplace принимает поисковые запросы по товарам или полные URL поиска Marketplace. Каждое действие обращается к своему набору данных, а не возвращает одни и те же результаты под разными названиями полей. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Facebook?
Объявленная схема включает text, author_name, author_username и author_id. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Facebook возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync и режим выдачи: async.