Facebook投稿の詳細を取得（リアルタイム）

Facebookの投稿1件をプラットフォームから直接収集し、呼び出し時点の内容とエンゲージメント数を返します。

GET/api/v1/facebook/realtime/post/detail

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 100 単位消費されます。

リクエストパラメータ

必須パラメータ

名前	位置	型	説明
`post_url`	query	string	post url example: https://www.facebook.com/nike/posts/pfbid0Z2KUg35AkAJeQJ6NRMyZViPnZD1b6wDMNP8L1UUNUFuYryVnw5DJUZGskYSWue4kl

レスポンスフィールド

名前	型	説明
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.post_id`	string	Post ID
`data.post_url`	string	Post URL
`data.description`	string	Post text
`data.cover_url`	string	Cover image URL
`data.publish_at`	string	Publish time
`data.like_count`	integer	Like count
`data.comment_count`	integer	Comment count
`data.share_count`	integer	Share count
`data.view_count`	integer	Play count
`data.media_type`	string	Media type
`data.resources`	array<string>	Resource URLs
`data.author_id`	string	Author ID
`data.author_name`	string	Author name
`data.author_url`	string	Author URL
`data.caption_text`	string	Caption text
`data.duration_seconds`	number	Duration (seconds)
`data.video_sd_url`	string	SD video URL
`data.video_hd_url`	string	HD video URL
`data.caption_urls`	array<string>	Subtitle URLs

お試し実行

リクエストURL

https://openapi.scdata.cc/api/v1/facebook/realtime/post/detail

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

post_url*

cURL の例

bash

curl -X GET "https://openapi.scdata.cc/api/v1/facebook/realtime/post/detail?post_url=https%3A%2F%2Fwww.facebook.com%2Fnike%2Fposts%2Fpfbid0Z2KUg35AkAJeQJ6NRMyZViPnZD1b6wDMNP8L1UUNUFuYryVnw5DJUZGskYSWue4kl" \
  -H "Authorization: YOUR_API_KEY"

レスポンス例 (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "post_id": "string",
    "post_url": "string",
    "description": "string",
    "cover_url": "string",
    "publish_at": "string",
    "like_count": 0,
    "comment_count": 0,
    "share_count": 0,
    "view_count": 0,
    "media_type": "string",
    "resources": [
      "string"
    ],
    "author_id": "string",
    "author_name": "string",
    "author_url": "string",
    "caption_text": "string",
    "duration_seconds": 0,
    "video_sd_url": "string",
    "video_hd_url": "string",
    "caption_urls": [
      "string"
    ]
  }
}

ユースケース

スポンサー投稿の報告 — 有料投稿の最終エンゲージメント数を記録します。
バイラル投稿監視 — 急速に拡散している投稿を一定間隔で再取得し、拡散度を計測します。