# リールを検索

**API:** Data API

**Endpoint:** `GET /v1/beta/instagram/reels/search`

**Tags:** Instagram

Instagram のログインが必要な検索ではなく Google 経由で、キーワードによりリールを検索します。shortcode、url、caption、video_url、video_duration、video_play_count、video_view_count、like_count、comment_count、owner、location、taken_at を持つリールと、next_page を返します。インデックスは Google のものであるため、網羅範囲は Google が公開インデックスしているものに限られ、Instagram 上のすべてではありません。date_posted は相対的な期間に絞り込みます。特定のハッシュタグを検索するには get_instagram_search_hashtag、クエリなしで今人気のものを知りたい場合は get_instagram_reels_trending を使います。

### 料金の参考情報

- 計量方式：結果件数単位で計量。
- 参考リクエスト見積もり：USD 0.00188。
- 参照用の顧客乗数：1.0。確定済みの顧客金額には再適用しないでください。

参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `date_posted` | query | no | string |  |
| `limit` | query | no | string |  |
| `page` | query | no | string |  |
| `query` | query | no | string |  |

## Responses

### 200 — 成功レスポンス

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

Schema: `ResponseA9E1Aef9F4F7_InstagramReelsResponse` (`#/components/schemas/ResponseA9E1Aef9F4F7_InstagramReelsResponse`)

Example:

```json
{
  "success": true,
  "credits_remaining": 33929349,
  "reels": [
    {
      "id": "3723045213787686915",
      "__typename": "XDTGraphVideo",
      "shortcode": "DOq6eV6iIgD",
      "url": "https://www.instagram.com/reel/DOq6eV6iIgD/",
      "caption": "Dogs are family 💙\n\nI met Rocco, a little rescue Chihuahua all the way from Mexico 🇲🇽🐾 \n\nHe’s looked after by a lovely lady who’s always had dogs, but when she lost her last one, she thought that was it, the loss is too painful to go through again. But babysitting Rocco gives her her “dog fix” and keeps her connected to the love only dogs can bring 🥰\n\nShe’s originally from Los Angeles, but now a New Yorker, and knows Central Park inside out from years of walking dogs there 🌳🐕 \n\nShe told me how dogs are family, and people who don’t love animals will never fully understand it, and I completely agree! ❤️\n\n#dogphotography #rescuedog #chihuahua #dogportrait #dogphotographer",
      "thumbnail_src": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-15/550186015_17890754136343371_4563383710172988045_n.jpg?stp=c0.280.720.720a_dst-jpg_e15_s640x640_tt6&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QEgFUe8Hj_UR-Af4n8brIqO2O_yZfoRHnHjM_VSEqFgfOpJoZ-_uIv8BVvGuSnLWQw&_nc_ohc=d5Wmai9i7L0Q7kNvwH6u4n-&_nc_gid=rIrCBBTCedpkbi2BFdOeJA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AfkaB2Nw4i5OiJscl0BtYIQRdenm5DyobWgTmjiq98BkcQ&oe=695A1764&_nc_sid=d885a2",
      "display_url": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-15/550186015_17890754136343371_4563383710172988045_n.jpg?stp=dst-jpg_e15_tt6&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QEgFUe8Hj_UR-Af4n8brIqO2O_yZfoRHnHjM_VSEqFgfOpJoZ-_uIv8BVvGuSnLWQw&_nc_ohc=d5Wmai9i7L0Q7kNvwH6u4n-&_nc_gid=rIrCBBTCedpkbi2BFdOeJA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_AflECyxYDTLWJ-OPnPag49aqgx6CniLKmOaUAGMGXrkDxg&oe=695A1764&_nc_sid=d885a2",
      "video_url": "https://scontent-sjc3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPtJA5EnMaKK-MNttf3RtYeQCVd-RvC7-juqeJiRkM3tKOkES_-1_ejsPDHgHGZ-xl4in8i3l38K12FlyUWKsieKzs2fGzo1GYOYJI.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_ohc=YBLRFw3fFXcQ7kNvwGKHSNS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6Nzg4NjQ4MjQzNTUwNjIxLCJhc3NldF9hZ2VfZGF5cyI6MTA1LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NzUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=8331fe48c9c9d742&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85NjQ3MjM4QTg3QjMzMzVCNEVBNDI2NEUzRTIyRTNBRV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYOnBhc3N0aHJvdWdoX2V2ZXJzdG9yZS9HRGFlcnlEbFRCTkhBbXdGQUk1d0lORGFpWEk3YnFfRUFBQUYVAgLIARIAKAAYABsCiAd1c2Vfb2lsATEScHJvZ3Jlc3NpdmVfcmVjaXBlATEVAAAmuubGpq_R5gIVAigCQzMsF0BS7MzMzMzNGBJkYXNoX2Jhc2VsaW5lXzFfdjERAHX-B2XmnQEA&_nc_gid=rIrCBBTCedpkbi2BFdOeJA&_nc_zt=28&oh=00_Afnoz52f0MquXCMwfTVoxg7ArrUBU0IM-BhI13EbDc8qKg&oe=695618AE",
      "has_audio": false,
      "accessibility_caption": null,
      "video_view_count": 21808,
      "video_play_count": 46018,
      "product_type": "clips",
      "video_duration": 75.7,
      "clips_music_attribution_info": {
        "artist_name": "Oliver Max",
        "song_name": "Smiling Heart",
        "uses_original_audio": false,
        "should_mute_audio": false,
        "should_mute_audio_reason": "",
        "audio_id": "1711608879787237"
      },
      "is_video": true,
      "owner": {
        "id": "70127159370",
        "username": "fetchmycamera_",
        "is_verified": true,
        "profile_pic_url": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-19/464124732_886472936919742_2388131534569981752_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QEgFUe8Hj_UR-Af4n8brIqO2O_yZfoRHnHjM_VSEqFgfOpJoZ-_uIv8BVvGuSnLWQw&_nc_ohc=zUH1QNaBCjYQ7kNvwEvfJoG&_nc_gid=rIrCBBTCedpkbi2BFdOeJA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afl7bOnEEqOQh9YqpKjOfS9Nly8_GgqVf-UHM2PXwEnrRQ&oe=695A1C46&_nc_sid=d885a2",
        "full_name": "Mark | Dog Photographer & Storyteller",
        "is_private": false,
        "is_unpublished": false,
        "follower_count": 188406,
        "post_count": 117
      },
      "taken_at": "2025-09-16T16:56:45.000Z",
      "is_ad": false,
      "like_count": 3487,
      "is_affiliate": false,
      "is_paid_partnership": false,
      "location": {
        "id": "110103980565013",
        "has_public_page": true,
        "name": "Central Park, New York City",
        "slug": "central-park-new-york-city",
        "address_json": "{\"street_address\": \"5th Avenue & 59th Street - Grand Army Plaza\", \"zip_code\": \"10019\", \"city_name\": \"New York, New York\", \"region_name\": \"\", \"country_code\": \"\", \"exact_city_match\": false, \"exact_region_match\": false, \"exact_country_match\": false}"
      },
      "comment_count": 90,
      "comments": [
        {
          "id": "17987217557879174",
          "text": "😍",
          "owner": {
            "id": "59201694781",
            "is_verified": false,
            "profile_pic_url": "https://scontent-sjc3-1.cdninstagram.com/v/t51.2885-19/487953757_1207254180975255_6791368254609466885_n.jpg?stp=dst-jpg_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby41ODkuYzIifQ&_nc_ht=scontent-sjc3-1.cdninstagram.com&_nc_cat=103&_nc_oc=Q6cZ2QEgFUe8Hj_UR-Af4n8brIqO2O_yZfoRHnHjM_VSEqFgfOpJoZ-_uIv8BVvGuSnLWQw&_nc_ohc=qE_Ww23SCnYQ7kNvwH_hlCD&_nc_gid=rIrCBBTCedpkbi2BFdOeJA&edm=ANTKIIoBAAAA&ccb=7-5&oh=00_Afn9DKpQeyNf-M17weq6PlGfa-TnjHbUWDOMSLsw-0Q3IQ&oe=695A2603&_nc_sid=d885a2",
            "username": "bslattt_official"
          },
          "like_count": 0,
          "created_at": "2025-11-14T17:34:59.000Z"
        }
      ]
    }
  ]
}
```

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseA9E1Aef9F4F7_InstagramReelsResponse

`#/components/schemas/ResponseA9E1Aef9F4F7_InstagramReelsResponse`

```json
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "credits_remaining": {
      "type": "integer"
    },
    "reels": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "cursor": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": true
}
```