リクエスト時にInstagramからクリエイターの最新投稿を直接取得します。数時間以内に公開されたコンテンツや、データベースの値が古い場合に使用してください。リアルタイム収集はデータベース読み取りより多くのクォータを消費します。
GET
/api/v1/instagram/realtime/user/mediasクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 100 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
user_id | query | string | user_id example: 13460080 |
任意パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
offset | query | string | offset |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.more | boolean | Has more |
data.offset | string | offset |
data.medias | array<object> | medias |
お試し実行
https://openapi.scdata.cc/api/v1/instagram/realtime/user/medias
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
user_id*offsetcURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/instagram/realtime/user/medias?user_id=13460080" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"more": true,"offset": "string","medias": [{"author_user_id": "string","author_username": "string","author_nickname": "string","media_id": "string","media_code": "string","create_at": "2019-08-24T14:15:22.123Z","cover_url": "string","resources": ["string"],"description": "string","accessibility_caption": "string","media_url": "string","media_type": 0,"duration": 0,"like_count": 0,"comment_count": 0,"play_count": 0}]}}
ユースケース
- キャンペーン納品確認 — スポンサー投稿が公開されたことを確認し、公開直後のエンゲージメントを記録します。
- トレンド把握 — 複数のクリエイターの最新投稿を定期取得し、新しいトピックを早期に発見します。