# Facebook API

整理 Facebook 公开主页、帖子评论、广告库素材和 Marketplace 商品挂牌，用于商家内容与推广调研；部分资料需通过异步任务取得。

- Domain: social · 16 data actions
- Canonical page: https://everyinfra.com/facebook-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 1152 credits ($16 / 千次) per 10 rows asked
- Required: keyword

- Optional: content_type, since, until
- Allowed values: content_type (latest/most_popular)

- Returns fields: 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 — 主页或对象详情
- Mode: async · Price: 200 credits ($2.78 / 千次)
- Required: url

- Returns fields: id, name, url, bio, category, like_count, follower_count, is_verified, phone, email, website, rating, rating_scale, avatar_url, platform

### user_posts — 用户内容
- Mode: async · Price: 200 credits ($2.78 / 千次)
- Required: url

- Returns fields: 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 — 单条内容
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: 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 — 评论
- Mode: async · Price: 200 credits ($2.78 / 千次)
- Required: url

- Returns fields: id, text, author_name, author_username, depth, reply_to_id, comment_url, author_id, author_url, like_count, reply_count, posted_at, platform

### followers — 粉丝数量
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: username

- Optional: channel

- Returns fields: id, username, url, follower_count, following_count, post_count, like_count, connection_count, precision, platform

### ads — 广告素材
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Optional: country, status

- Returns fields: 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 — 群组帖子
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Optional: sort

- Returns fields: id, url, text, posted_at, like_count, comment_count, share_count, author_id, author_name, author_url, group_url, platform

### marketplace — 市集商品
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Optional: location

- Returns fields: id, url, name, price, currency, city, state, condition, image_url, posted_at, platform

### reviews — 评价
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, text, is_recommended, rating, rating_scale, posted_at, like_count, comment_count, author_id, author_name, author_url, platform

### advertiser_search — 广告主搜索
- Mode: sync · Price: 63 credits ($0.88 / 千次)
- Required: keyword

- Returns fields: id, name, username, url, category, avatar_url, page_like_count, is_verified, instagram_username, instagram_follower_count, instagram_verified, country, platform

### ad_detail — 广告详情
- Mode: sync · Price: 69 credits ($0.96 / 千次)
- Required: url

- Returns fields: 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 — 活动搜索
- Mode: sync · Price: 69 credits ($0.96 / 千次)
- Required: keyword

- Optional: page_token

- Returns fields: 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 — 市集商品详情
- Mode: sync · Price: 69 credits ($0.96 / 千次)
- Required: url

- Returns fields: 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 — 主页活动
- Mode: sync · Price: 69 credits ($0.96 / 千次)
- Required: url

- Optional: page_token

- Returns fields: id, url, name, starts_at, date_text, place_name, city, host_name, is_online, is_past, is_canceled, next_page_token, platform

### post_transcript — 视频帖文稿
- Mode: sync · Price: 69 credits ($0.96 / 千次)
- Required: url

- Returns fields: id, url, text, duration_seconds, duration_sec, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md