InstagramPost embed codeAPI
POST
APIの稼働状況
- 24時間の稼働状況
- 正常
- 良好/正常
- 利用可能
- 制限あり
- ほぼ停止
正常
過去24時間
過去30日間
Get the oEmbed data and embed code for one Instagram post or Reel from its url: the same fields as Instagram's official oEmbed, with html ready to paste into a web page.
POST https://api.everyinfra.com/api/v1/socialを送信し、platformにinstagram、actionにoembedを指定します。 料金は1,000リクエストあたり$0.56(1回あたり$0.000556)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。
AIプロンプト
#EveryInfraのInstagram Post embed codeエンドポイント(instagram/oembed)を使ったデータ収集スクリプトの作成を手伝ってください。
エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにinstagram、actionにoembedを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ:
- url: A post or Reel link, such as https://www.instagram.com/p/<shortcode>/ or https://www.instagram.com/reel/<shortcode>/.
- 任意パラメータ:
- hidecaption: true hides the post caption in the embed. Defaults to false.
- maxwidth: Maximum embed width in pixels, an integer from 320 to 658. Defaults to 540.
- 1つのオブジェクトを返します。主なフィールド: version((oembed) oEmbed version, 1.0)、type、title、author_name、author_url、author_id、media_id(The numeric post ID)、provider_name((oembed) Always Instagram)、provider_url((oembed) Always https://www.instagram.c…)、width(元の画像または動画の幅(ピクセル))、html((oembed) Embed code: a blockquote plus…)、thumbnail_url。フィールドは全部で16個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=instagramを参照してください。.
- リクエストボディの例:
{
"platform": "instagram",
"action": "oembed",
"params": {
"url": "https://www.instagram.com/p/DbYmqpplO_N/"
}
}
- 料金:1,000リクエストあたり$0.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。
コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。リクエストパラメータ
#| 名前 | 場所 | 型 | 必須 | デフォルト | 説明 |
|---|---|---|---|---|---|
Authorization | header | string | はい | - | Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。 |
platform | body | string | はい | instagram | プラットフォームの識別子です。値は固定です。 |
action | body | string | はい | oembed | 機能の識別子です。値は固定です。 |
url | body.params | string | はい | - | A post or Reel link, such as https://www.instagram.com/p/<shortcode>/ or https://www.instagram.com/reel/<shortcode>/. |
hidecaption | body.params | boolean | いいえ | - | true hides the post caption in the embed. Defaults to false. |
maxwidth | body.params | integer | いいえ | - | Maximum embed width in pixels, an integer from 320 to 658. Defaults to 540. |
コードサンプル
#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": "instagram",
"action": "oembed",
"params": {
"url": "https://www.instagram.com/p/DbYmqpplO_N/"
}
}'OpenAPI定義(JSON)サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。
レスポンス例
#November 21, 2026 at 07:18(UTC)に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報(名前、ハンドル、アバター、プロフィールリンク、連絡先)を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
json
{ "id": "req_…", "platform": "instagram", "action": "oembed", "results": { "version": "1.0", "type": "rich", "title": "The Sun and Moon are coming together to put on a show for Earth, and we'll be sharing it with you. 😎\n\nOn Aug. 12, a total solar eclipse will pass over Earth, and we'll be broadcasting it live along the path of totality. Check our link in bio to learn how to watch along with us!\n\n…", "author_name": "n•••a", "author_url": "https://www.instagram.com/•••", "author_id": "•••", "media_id": "3952078729724096461_528817151", "provider_name": "Instagram", "provider_url": "https://www.instagram.com", "width": 540, "html": "<blockquote class=\"instagram-media\" data-instgrm-captioned data-instgrm-permalink=\"https://www.instagram.com/reel/DbYmqpplO_N/?utm_source=ig_embed&utm_campaign=loading\" data-instgrm-version=\"14\" style=\" background:#FFF; border:0; border-radius:3px; box-shadow:0 0 1px 0 rgba(0…", "thumbnail_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/760192799_18631809481049152_7782886010573196119_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ig_cache_key=Mzk1MjA3ODcyOTcyNDA5NjQ2MTE4NjMxODA5NDc1MDQ5MTUy.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3…", "thumbnail_width": 1080, "thumbnail_height": 1920, "shortcode": "DbYmqpplO_N", "url": "https://www.instagram.com/reel/DbYmqpplO_N/", "platform": "instagram" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
レスポンスフィールド
#業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。
| フィールド | 意味 |
|---|---|
version | (oembed) oEmbed version, 1.0. |
type | レコードの種類です。値は機能によって異なります(例:video / image / text)。 |
title | タイトルです。プラットフォームにタイトルがない場合(テキストのみの投稿など)はnullになります。 |
author_name | 投稿者の表示名です。 |
author_url | プラットフォーム上の投稿者プロフィールへのリンクです。 |
author_id | プラットフォーム上での投稿者の一意なIDです。 |
media_id | The numeric post ID. oembed gives it as postID_authorID. |
provider_name | (oembed) Always Instagram. |
provider_url | (oembed) Always https://www.instagram.com. |
width | 元の画像または動画の幅(ピクセル)。 |
html | (oembed) Embed code: a blockquote plus Instagram's embed.js that shows the official embed card. |
thumbnail_url | サムネイルのリンクです。image_urlより低解像度です。 |
thumbnail_width | (oembed) Thumbnail width in pixels. |
thumbnail_height | (oembed) Thumbnail height in pixels. |
shortcode | The post shortcode: the part of the post link after /p/ or /reel/. |
url | プラットフォーム上のレコードへのリンクです。 |
platform | 取得元プラットフォームの識別子で、リクエストのplatformと同じです(例:xiaohongshu、tiktok)。 |
エラーと課金
#- 401
- キーが未指定か無効です。
- 402
- 残高が不足しています。先にチャージしてください。
- 422
- パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
- 429
- 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
- 503
- 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
- 200(空)
- データがありません。課金はされません。