> ## 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.

# 获取群组视频

> 获取群组视频。仅支持公开群组。如果没有返回数据，请检查该群组是否为私密群组。使用 cursor 参数获取下一页数据。

<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/group_videos
摘要: 获取群组视频

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

参数:
- group_id (必填): Facebook 群组 ID. 示例: 1571965316444595
- 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/group_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/group_videos:
    get:
      tags:
        - 群组
      summary: 获取群组视频
      description: 获取群组视频。仅支持公开群组。如果没有返回数据，请检查该群组是否为私密群组。使用 cursor 参数获取下一页数据。
      parameters:
        - name: group_id
          in: query
          description: Facebook 群组 ID。
          required: true
          example: '1571965316444595'
          schema:
            type: string
            example: '1571965316444595'
        - 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:
                  videos:
                    - id: '1412677107475667'
                      url: >-
                        https://www.facebook.com/juice.ortiz.98/videos/1412677107475667/?idorvanity=1571965316444595
                      message: >-
                        Lots more watching and not enough dancing over
                        firefighters' weekend. Afraid to step on the dance
                        floor?

                        Join DeLene Hoffner every Monday night at All About
                        Dance off Vickers in Colorado Springs and learn basic,
                        fun, easy steps to strut with your partner round the
                        floor.


                        $15 for One Hour, Two-Step lessons

                        7-8pm every Monday

                        2590 Vickers Dr, Colorado Springs, CO 80918
                      image:
                        uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/797644346_1113548671356763_8889920165671430045_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=p843x403&_nc_cat=102&ccb=1-7&_nc_sid=117846&_nc_ohc=LWPcEpVSQxoQ7kNvwHYjOmp&_nc_oc=AdqnKPldh2lvYZfc0alMxijdnLAjJLYelNIryzXZRHnsxM3MBt-5rsHcsyl8YNmGhKw&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQIxe-FAiHVQruETwqs5qT0TOJ1LSZt0Fnkc6rZRZ5piQA&oe=6AB83332
                    - id: '1070917252588450'
                      url: >-
                        https://www.facebook.com/WhatsThe413Radio/videos/1070917252588450/?idorvanity=1571965316444595
                      message: >-
                        Come show us your pipes tonight at THE VIC !! 

                        @ [100000379745916:2048:Diana Maria Nunez] will be
                        mixing the drinks! Lets gooo!!
                      image:
                        uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/814939281_1616123003224512_9210044532986634753_n.jpg?stp=dst-jpg_tt6&cstp=mx592x1056&ctp=s592x1056&_nc_cat=105&ccb=1-7&_nc_sid=117846&_nc_ohc=z4KEe3HnmeMQ7kNvwGdEaTa&_nc_oc=AdrfFk6zZT-MYV57hw8EDnhoraRTLCd_lWiGw6Ag241VK5W-9JBzZhCMhj3smBQ3ybQ&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQIRDJEh6KFwnCNyXmBHqqrcMP7nB9C5gCT4ZczVzjcRWA&oe=6AB82E52
                    - id: '2004561440235196'
                      url: >-
                        https://www.facebook.com/ilse.venter.336/videos/2004561440235196/?idorvanity=1571965316444595
                      message: null
                      image:
                        uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t15.5256-10/814962658_1658878239284101_8733515013778057017_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=p843x403&_nc_cat=103&ccb=1-7&_nc_sid=117846&_nc_ohc=oXnAt5xnf5wQ7kNvwG-e17Y&_nc_oc=Adpv_ADhHxHLeoxqIdKoVscgwVpwF4n-HlTdBWuaAEOyqHBR72wmV6PLQVbVHTOFs2k&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQJ3p6KvqOLlBdd_YVx68nja5Z5h_k3QsxpHFaioJ61Vew&oe=6AB81CD8
                    - id: '1771105114212967'
                      url: >-
                        https://www.facebook.com/ilse.venter.336/videos/1771105114212967/?idorvanity=1571965316444595
                      message: null
                      image:
                        uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/813891477_1336902398306231_8191964037847136790_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=p843x403&_nc_cat=101&ccb=1-7&_nc_sid=117846&_nc_ohc=ei_KbkoUq7gQ7kNvwGWv62J&_nc_oc=AdoLlKmo8-8gNO2q2mMGv1FGcairp-28A5IO-McM-N7uagFJGu5hTI_MIC6SF1jXlJI&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQIGambRLofTL1XSiPKkClJ-Dh3mgfBR6JQLAoDe4Ki0PQ&oe=6AB811EE
                    - id: '1492422199374081'
                      url: >-
                        https://www.facebook.com/ilse.venter.336/videos/1492422199374081/?idorvanity=1571965316444595
                      message: null
                      image:
                        uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t15.5256-10/805485602_1411442483741503_5932574844299559122_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=p843x403&_nc_cat=109&ccb=1-7&_nc_sid=117846&_nc_ohc=3agX4UgMfmwQ7kNvwG0FAzB&_nc_oc=Ado_aDMdOQSwmACAzfjwU775tuKxmpRZL80OyJIe3Ajg31ziq3VsX8h-PZlpBo2rxvE&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQIZZN4N9knLMIXw0YoBKtQm_5KGP2bDXiXel1PrFD3b3Q&oe=6AB82DE7
                    - id: '1044667445284596'
                      url: >-
                        https://www.facebook.com/ilse.venter.336/videos/1044667445284596/?idorvanity=1571965316444595
                      message: null
                      image:
                        uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t15.5256-10/818250440_1078801978233065_731314950719709210_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=p843x403&_nc_cat=109&ccb=1-7&_nc_sid=117846&_nc_ohc=OsneCG3cJ9YQ7kNvwFZqyVW&_nc_oc=AdoKI8vc7CwDbV_I5wymDoWYZY_F1eaJe786YZepTDP51OYEJG5mHWZsYjwrVGWDcuY&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQJeJUyinx7XX9osYZ1cF8FrROdjy8FzYhHKNpTxUF470w&oe=6AB807DF
                    - id: '1682590410098792'
                      url: >-
                        https://www.facebook.com/61589150765719/videos/1682590410098792/?idorvanity=1571965316444595
                      message: Come join the fun.🎯🎯
                      image:
                        uri: >-
                          https://scontent-atl3-2.xx.fbcdn.net/v/t15.5256-10/813877531_1102911878906530_8448848677997638815_n.jpg?stp=dst-jpg_tt6&cstp=mx1080x1920&ctp=p843x403&_nc_cat=102&ccb=1-7&_nc_sid=117846&_nc_ohc=ZCMphGC7zW4Q7kNvwGKsRwS&_nc_oc=AdrtcKU4CpudGd2jLeeOIXFPgaiqIghd8IqvZoqNVZV1pb8QRKAUg36qTO_bEiRokps&_nc_zt=23&_nc_ht=scontent-atl3-2.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQLASQWUa6OJg-1ZVUcHw8Kj-BoBjYlIY9QwrgTX3j4f2A&oe=6AB83077
                    - id: '1732028735106891'
                      url: >-
                        https://www.facebook.com/61569423838021/videos/1732028735106891/?idorvanity=1571965316444595
                      message: >-
                        Come see us on October 8th at Sunshine Studios Live with
                        Smile Empty Soul and Revis! Get your tickets at the link
                        below!


                        https://wl.eventim.us/event/revis-smile-empty-soul/696576?afflky=SunshineStudiosLive&eventpass=Beforevegas&ttc=1884979


                        #livemusiccolorado #coloradospringsconcert #411inthe719
                      image:
                        uri: >-
                          https://scontent-atl3-1.xx.fbcdn.net/v/t15.5256-10/808190320_1500076938710099_909170818793087499_n.jpg?stp=dst-jpg_tt6&cstp=mx720x1280&ctp=s720x1280&_nc_cat=103&ccb=1-7&_nc_sid=117846&_nc_ohc=cp-OE5ZLp_gQ7kNvwEgA7fa&_nc_oc=Adodb-2Tm-26dI3S3N1vwLZoH5yT1RFRPkmxBom3NF3YYwqFixodINWPojMAg2YHz_E&_nc_zt=23&_nc_ht=scontent-atl3-1.xx&_nc_gid=UnBIcC0vnZ42nh3t1lPExg&_nc_ss=7d289&oh=00_AQLw2jk2SujKHWjQuQqpmoUvH4KR8TivNVWJHw0ymTE89A&oe=6AB81915
                  cursor: >-
                    AQHTcCnom1G8ZrdcBpML45pZ9Fg2YuxBS5sKh0deARCnr3eyYqcQYNpQcrHAPr357zmsK3CsiyQYkV4DvBx7CNSSqg
                requestId: c41f7eae-4167-45da-b32d-6ad644257632
          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。

````