> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 通过公共主页 delegate ID 获取视频

> 通过公共主页 delegate ID 获取视频。请使用 delegate ID，而不是 page ID。

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">4 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## 复制给 AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 为什么还要自己写代码？</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">让 AI 来处理重复工作。点击按钮即可复制一段整理好的提示词，用于 ChatGPT、Claude 或你常用的 AI 助手。</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`我需要调用下面的 KeyAPI 接口，请根据提供的接口信息生成一份完整、可直接运行的 Python 示例代码。

## 接口信息

Endpoint: GET https://api.keyapi.ai/v1/facebook/page_videos
摘要: 通过公共主页 delegate ID 获取视频

必需请求头:
- Authorization: Bearer <YOUR_API_KEY>

参数:
- delegate_page_id (必填): 公共主页 delegate ID. 示例: 20531316728
- cursor (可选): 分页游标，用于获取下一页数据.

## 代码要求

- 使用 Python \`requests\` 库
- 提供完整、可直接运行的示例
- 处理 HTTP 请求异常、超时以及非 2xx 响应
- 处理 JSON 解析异常
- 示例参数优先使用接口信息中提供的 Example
- 保持代码简单，避免不必要的封装和复杂设计`)}
    >
      <span>✨</span>
      <span>复制给 AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml /zh/facebook.zh.openapi.json get /v1/facebook/page_videos
openapi: 3.0.1
info:
  title: KeyAPI Facebook API 中文文档
  description: KeyAPI Facebook API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production-KeyAPI
security:
  - JWT Bearer: []
tags:
  - name: 公共主页
  - name: 个人主页
  - name: 群组
  - name: 帖子与评论
  - name: 广告库
  - name: 活动
  - name: 搜索
  - name: Marketplace
  - name: 游戏
paths:
  /v1/facebook/page_videos:
    get:
      tags:
        - 公共主页
      summary: 通过公共主页 delegate ID 获取视频
      description: 通过公共主页 delegate ID 获取视频。请使用 delegate ID，而不是 page ID。
      parameters:
        - name: delegate_page_id
          in: query
          description: 公共主页 delegate ID。
          required: true
          example: '20531316728'
          schema:
            type: string
            example: '20531316728'
        - name: cursor
          in: query
          description: 分页游标，用于获取下一页数据。
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  results:
                    - video_id: '1346514350800865'
                      url: >-
                        https://video.fruh6-2.fna.fbcdn.net/o1/v/t2/f2/m412/AQOYUsH4T4C-g4ptJ5PGTAliYKm0Qw_hwQ63FvE6DxjbTNq56Y5aWlzPYK8bUNJBV_-PENGz_m673-OuNw0b2RVO12Brm5jfUUvdszWoqQ.mp4?_nc_cat=105&_nc_oc=Adpln2iiluqYpYbc1C7iVohnLOuaEbDzfNKijuu4PVWo9DOr79xjRe-UGKbWiODL294&_nc_sid=8bf8fe&_nc_ht=video.fruh6-2.fna.fbcdn.net&_nc_ohc=NGddLPw7004Q7kNvwEf8zdx&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTcyNzc1ODYxMTgxMTA1NCwiYXNzZXRfYWdlX2RheXMiOjE3LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6NjQsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQJzqKS4ztA6jdGhaTWwGj-YU7SKOd6b85V9si5evy231A&oe=6AB81B5D&bitrate=312155&tag=sve_sd
                      description: >-
                        With the Seller app, you can take your Marketplace game
                        to the next level. Manage bulk listings, markdowns and
                        more — all in one place. Take it from self-proclaimed
                        Marketplace “fiend”  Vinny Anatra : “It’s the real
                        deal.”

                        Video by @vinny.anatra
                      timestamp: 1788537896
                      length_in_ms: 64814
                      play_count: 750854
                      reactions_count: 6364
                      author:
                        id: '100064860875397'
                        delegate_page_id: '20531316728'
                      thumbnail_uri: >-
                        https://scontent.fruh6-2.fna.fbcdn.net/v/t15.5256-10/795252703_914866637935361_204394371684686302_n.jpg?_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=pYLqO9lQ0JMQ7kNvwEOi7xa&_nc_oc=Adqe98_q4X3NrH4wqekv9M5kc7pxYIot7-lRn2kRQdeUKe445027KldzmHkjoIayQ4Y&_nc_zt=23&_nc_ht=scontent.fruh6-2.fna&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&oh=00_AQLBj-3RR2cXNfavWFHbIPuloBpwePyihWqHJcgKB1ol6g&oe=6AB82BBE
                    - video_id: '1807623153746790'
                      url: >-
                        https://video.fruh6-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQOLWpG_5lq_HZaLdyvoGPMve852YT4IeJjbDWXdSzV6nX8keDCiHavgDOB-cOJMU4kyxWbx-hEgaO6v5COEhskuR1uFG7FDRSneDetOMw.mp4?_nc_cat=103&_nc_oc=AdqomU7_EQ52GxksdhqSjpN_N1qy-8wu4_6T8l2IqEGvuzZi88dlCGV2MMe4EBuA9Ws&_nc_sid=8bf8fe&_nc_ht=video.fruh6-1.fna.fbcdn.net&_nc_ohc=2-sWbwZyBtIQ7kNvwFdFmIg&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MjMwNTY0MDA3MzUyNzU1NiwiYXNzZXRfYWdlX2RheXMiOjIwLCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQLKVGKg_q0kWf4IYcePufqDqFZ2VrPiN9w6rALwmIUaVw&oe=6AB8297F&bitrate=945311&tag=sve_sd
                      description: >-
                        This is what happens when you actually follow the travel
                        group's recs 🏔️


                        Video by @madetotravel0
                      timestamp: 1788278264
                      length_in_ms: 12736
                      play_count: 762925
                      reactions_count: 4719
                      author:
                        id: '100064860875397'
                        delegate_page_id: '20531316728'
                      thumbnail_uri: >-
                        https://scontent.fruh6-2.fna.fbcdn.net/v/t15.5256-10/790722852_1799025124459508_6593599401898867097_n.jpg?_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=K_5LfBBD-9sQ7kNvwHG6nbc&_nc_oc=AdqtVJQQENbuFgJz1LueSMqqlWXfJhkoMi2yUS-dFV3RfDrImEcQl9gFGOnjFZoRhWE&_nc_zt=23&_nc_ht=scontent.fruh6-2.fna&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&oh=00_AQKcki2FojcHfKVytg6-BUFyO3VjejBI0rMbMvO4srcAzw&oe=6AB80C79
                    - video_id: '1780520503143917'
                      url: >-
                        https://video.fruh6-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQM23w50cqrV-aT9E7A_vwWMp2du--hK44xlchrKACdoCjPU_qN2Ml50WNFIVfNrKnxHiLb-7tyVAoJRp4z0pZ95h9FGGKbh_-IG6bwi2g.mp4?_nc_cat=108&_nc_oc=AdrkRC7Xc-0tLW0JVFYRM5s7KLIJwkB6K0N-CmB41-bldUgDNjROOOiJTRk1_i8tsQo&_nc_sid=8bf8fe&_nc_ht=video.fruh6-1.fna.fbcdn.net&_nc_ohc=gsWcbftoN0MQ7kNvwHaiXzu&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTM5OTQ3NjUxMjI1MDM2OSwiYXNzZXRfYWdlX2RheXMiOjI1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MzEsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQJOLHbewAGknrvTGnTDDkQD3o7VKYWtneO1OFjvRvlm6A&oe=6AB81EBE&bitrate=241321&tag=sve_sd
                      description: >-
                        The friend who sends you 12 listings before noon. We
                        love them for it ❤️

                        Video by sydwingold
                      timestamp: 1787860219
                      length_in_ms: 31433
                      play_count: 511796
                      reactions_count: 5771
                      author:
                        id: '100064860875397'
                        delegate_page_id: '20531316728'
                      thumbnail_uri: >-
                        https://scontent.fruh6-1.fna.fbcdn.net/v/t15.5256-10/788072828_1764011391414564_1066716276780196304_n.jpg?_nc_cat=106&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=ro69T1vQfxAQ7kNvwG_GuFW&_nc_oc=AdrMdAY-7Rc-QgVmG-aYxafuCG3K8q2SWgJtauYEb6pW3qKQvc1LjqzaDyJWfVZBIj8&_nc_zt=23&_nc_ht=scontent.fruh6-1.fna&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&oh=00_AQKyFvQtVxQoROtx5YvlpNFBfXw8tSYe_e3_KScaZLzHTQ&oe=6AB8330F
                    - video_id: '1362559125990523'
                      url: >-
                        https://video.fruh6-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQPbQKNjVx9gmKgcp5wz8BPwzi9xD8S5y-W-tzfIim4fh9Ruuu03KfvKP6hgwNxtpBBEjXEpx5r6iR1JhQ504kBlX8CoUJVABbHTR0-8pg.mp4?_nc_cat=106&_nc_oc=AdqnEegRnfWQnN6_1_RhSIxfRYh_kT6rAMqyPxdWphMAeBnAg1bxnDoJCJ4HatjMxIQ&_nc_sid=8bf8fe&_nc_ht=video.fruh6-1.fna.fbcdn.net&_nc_ohc=p4C_ACc0QXQQ7kNvwFOa1Ob&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6NDA5Mzk1NjcxMDczNTAxNywiYXNzZXRfYWdlX2RheXMiOjI1LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6MjMsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQJgc4lecPCoKh_MeE73F7WSphxhiVEcQXKOarjpbSFtyw&oe=6AB8017C&bitrate=514172&tag=sve_sd
                      description: >-
                        POV: Taking in all the sights I learned about in a
                        Facebook travel group

                        Video by @thejourneyest2016

                        Music by @TheProclaimers
                      timestamp: 1787848337
                      length_in_ms: 23210
                      play_count: 3332005
                      reactions_count: 28187
                      author:
                        id: '100064860875397'
                        delegate_page_id: '20531316728'
                      thumbnail_uri: >-
                        https://scontent.fruh6-2.fna.fbcdn.net/v/t15.5256-10/787434539_1070984285904750_9128437787800217787_n.jpg?_nc_cat=100&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=5kD3eLa6-pEQ7kNvwF680kA&_nc_oc=AdolPKxeNUM1msXDeQ8fmPOMK7TcJXxKkV-r79DYW5vQIkXLEYLi5JOSqoyZL2XORLM&_nc_zt=23&_nc_ht=scontent.fruh6-2.fna&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&oh=00_AQJ1T7ATpVKFQGnnFL0qsxgY5jch4jRGnY5lEAfEymYntQ&oe=6AB834C1
                    - video_id: '2534776633689692'
                      url: >-
                        https://video.fruh6-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQM9lZU6Q1t8yAzEjG5hugqv3bxqdMlwx60wdA5UyjP04Jeh4tLEoZuSG0Ez_6VWizS-JACL3AOtfJ1onO0rHOrPTmVm9zDiZtKPBxdNLg.mp4?_nc_cat=105&_nc_oc=AdqQoSJmcMCsOesPyUkV6mVhAhGy3Dm-n43wzb5J8B-ij_U_dXCGJJmEIUoyr8FDp78&_nc_sid=8bf8fe&_nc_ht=video.fruh6-1.fna.fbcdn.net&_nc_ohc=o0WJN0iyyNMQ7kNvwFF99z4&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6MTYxMTU2NDkxMzkxNzg3NSwiYXNzZXRfYWdlX2RheXMiOjI4LCJ2aV91c2VjYXNlX2lkIjoxMDEyMiwiZHVyYXRpb25fcyI6OSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQJJ8WwYobl_7aOXogvs0lifoDMtH9SUXL3tktsAca1yjg&oe=6AB82F49&bitrate=696040&tag=sve_sd
                      description: >-
                        Facebook creator Jakethejuice is fired up by the US Open
                        and giving tennis a (trick) shot. 


                        If you also have tennis fever, Facebook Groups can help
                        you get in the game. "Find a Tennis Partner" connects
                        you with fellow players wherever you are, and "Tennis
                        Education" offers tips for beginners, as well as a
                        community that shares your love of the game 🎾
                      timestamp: 1787592059
                      length_in_ms: 9472
                      play_count: 448134
                      reactions_count: 4111
                      author:
                        id: '100064860875397'
                        delegate_page_id: '20531316728'
                      thumbnail_uri: >-
                        https://scontent.fruh6-1.fna.fbcdn.net/v/t15.5256-10/784250600_2117736055445041_1005567460232174922_n.jpg?_nc_cat=101&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=8Bhd81Mueo8Q7kNvwG8l0HB&_nc_oc=AdpxJ-MwPhtcma95a5up3HwRX_dN8vk9kPoXB7_xmdw5lzfqPR6qpqt2URFC2W8YfPM&_nc_zt=23&_nc_ht=scontent.fruh6-1.fna&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&oh=00_AQJFCG6w5WfjzgcTxB9OJIBKseJIS4aTWGC5MrwoUfyWJQ&oe=6AB82401
                    - video_id: '1665818941169475'
                      url: >-
                        https://video.fruh6-2.fna.fbcdn.net/o1/v/t2/f2/m412/AQNlJzLfQeahraCyUzZIrEGm-JV0brXwheQj9VDuLOXscFTdKitSH4xF73oAal7_nCwvMa_yIlTvHwH5ZKHxP5sU-yjhr3Ca6dbIuW2L3A.mp4?_nc_cat=103&_nc_oc=AdovSA30K2KY4yfAHcM4DySy8_Xxv0Ab6_PYIhxc-arMpZe0rpcXQ6SlJZy6VGt7AXg&_nc_sid=8bf8fe&_nc_ht=video.fruh6-2.fna.fbcdn.net&_nc_ohc=OJvGPT0bmJ4Q7kNvwGeBVVd&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5GQUNFQk9PSy4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6OTk1NDcwMTkwMTYwODY3LCJhc3NldF9hZ2VfZGF5cyI6NDYsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjo3NCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQIoBwjl28kUY5rTx-hLxMrOKCYkh35YxiEK18dJljRWGQ&oe=6AB81D4B&bitrate=519207&tag=sve_sd
                      description: >-
                        Stella Lefty’s Lolla debut was one for the books 🔥🪩


                        Last weekend, the Chicago-area native took the
                        Lollapalooza stage for the first time. Spend the day
                        with Stella as she preps for this moment and reflects on
                        the memories that shaped her upcoming debut album, "Long
                        Way Home” (out 8/21!). She shares what it's been like
                        watching her music take off IRL and on Facebook, and
                        previews her upcoming single, "Lean In, Kiss Me."
                      timestamp: 1786040678
                      length_in_ms: 74100
                      play_count: 427946
                      reactions_count: 5096
                      author:
                        id: '100064860875397'
                        delegate_page_id: '20531316728'
                      thumbnail_uri: >-
                        https://scontent.fruh6-1.fna.fbcdn.net/v/t15.5256-10/767268014_1588343466327589_6000410635555869036_n.jpg?_nc_cat=111&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=d2b52d&_nc_ohc=9vHU54f8TW8Q7kNvwFgY_lG&_nc_oc=AdoG4B6JqbuJxEqEoebuCh07BKnNSr9SxXqk-EeegVfWGoZPwAIgtjO1coIh9vvi97g&_nc_zt=23&_nc_ht=scontent.fruh6-1.fna&_nc_gid=hBKIUgjw4LQHXDVZ-QvupQ&_nc_ss=7d289&oh=00_AQLA_d8teYrkkSZsQuloXXvt1zkRRtqJFE0PNXQ6-IKRTw&oe=6AB83691
                  cursor: >-
                    AQHTfFb747S_nm2Sj-xWvPMUbavsdYlYXbGYKBNzMPmjXniUOUmzNR3wXBSg-DXmBAmSouJcH7zIswlF8vRpgK01OQ
                requestId: 7929621f-7165-437e-8389-c2b396f3eec5
          headers: {}
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '402':
          $ref: '#/components/responses/402'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
      deprecated: false
      security:
        - JWT Bearer: []
components:
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            type: object
            example:
              code: 400
              data: null
              message: 'Missing required parameter: handle'
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            example:
              code: 401
              data: null
              message: apiKey is null
    '402':
      description: Payment Required
      content:
        application/json:
          schema:
            type: object
            example:
              code: 402
              data: null
              message: apiKey quota is not enough
    '429':
      description: Too Many Requests
      content:
        application/json:
          schema:
            type: object
            example:
              code: 429
              data: null
              message: qps limit exceeded
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            example:
              code: 500
              data: null
              message: Internal server error
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````