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

# 获取用户精选

> 获取Instagram用户的精选故事（Highlights）列表。精选是用户保存的故事合集

<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">2 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">每次请求</span></span>
</div>

## Copy for 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">🤖 让 AI 帮你写调用代码</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">点击按钮复制一段结构化提示词，可直接交给 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 接口：GET https://api.keyapi.ai/v1/instagram/fetch_user_highlights\n\n请帮我编写调用代码，并包含必要的错误处理、参数校验和响应处理逻辑。\n\n接口信息：\n\nEndpoint: GET https://api.keyapi.ai/v1/instagram/fetch_user_highlights\n\nDescription: Instagram 的「用户 Highlights」接口返回业务处理所需的数据字段和状态信息。适用于账号研究、内容分析、互动监测和社媒运营。可结合接口参数进行筛选或分页查询。\n\nRequired Headers:\n--header 'Authorization: Bearer <YOUR_API_KEY>'\n\nParameters:\n- username (Optional): 用户名. Example: javan\n- user_id (Optional): 用户 ID. Example: 18527\n\nExample Response:\n{\n  \"code\": 0,\n  \"message\": \"success\",\n  \"data\": {\n    \"data\": {\n      \"count\": 1,\n      \"highlights_tray_type\": \"DEFAULT\",\n      \"items\": [\n        {\n          \"can_gif_quick_reply\": true,\n          \"can_react_with_avatar\": false,\n          \"can_reply\": true,\n          \"can_reshare\": true,\n          \"contains_stitched_media_blocked_by_rm\": false,\n          \"cover_media\": {\n            \"crop_rect\": [\n              0.035046728971962614,\n              0.34706397896581953,\n              0.9649532710280374,\n              0.8702892199824716\n            ],\n            \"cropped_image_version\": {\n              \"height\": 150,\n              \"url\": \"https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/563420830_18120888430503568_5958508023765876008_n.jpg?stp=c44.792.1194.1194a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QGESkZtffl5gGFa-i_jphOys2-IHyQ4gia-yWAqWPeCi-JE-0E2hvhpmAZPtl2RE8M&_nc_ohc=J7IfOjYBEZQQ7kNvwEZdq2A&_nc_gid=SRXzArdDf2hgbTTDQuUxnA&edm=ALbqBD0BAAAA&ccb=7-5&oh=00_Afy7rw9nNHPw-XbY6pd6GkBq_8lqtiG89Eea2JSxo--jcQ&oe=69B5774B&_nc_sid=847350\",\n              \"width\": 150\n            },\n            \"full_image_version\": null,\n            \"id\": \"2546507643239612773\",\n            \"upload_id\": null\n          },\n          \"created_at\": 1622103441,\n          \"highlight_reel_type\": \"DEFAULT\",\n          \"id\": \"highlight:17927864314604086\",\n          \"is_archived\": false,\n          \"is_converted_to_clips\": false,\n          \"is_nux\": false,\n          \"is_pinned_highlight\": false,\n          \"latest_reel_media\": 1633609801,\n          \"media_count\": 34,\n          \"prefetch_count\": 0,\n          \"ranked_position\": -1633611895,\n          \"reel_type\": \"highlight_reel\",\n          \"seen_ranked_position\": -1633611895,\n          \"title\": \"Wallpapers\",\n          \"updated_timestamp\": 1633611895,\n          \"user\": {\n            \"account_badges\": [],\n            \"full_name\": \"Javan Ng\",\n            \"id\": \"18527\",\n            \"interop_messaging_user_fbid\": 105721380825451,\n            \"is_creator_agent_enabled\": false,\n            \"is_private\": false,\n            \"is_verified\": false,\n            \"profile_pic_id\": \"3459147014560655728\",\n            \"profile_pic_url\": \"https://scontent-lax3-1.cdninstagram.com/v/t51.2885-19/460170653_852233457013406_8133149038171915885_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QGESkZtffl5gGFa-i_jphOys2-IHyQ4gia-yWAqWPeCi-JE-0E2hvhpmAZPtl2RE8M&_nc_ohc=T43Z_QBhAnQQ7kNvwFgAFmZ&_nc_gid=SRXzArdDf2hgbTTDQuUxnA&edm=ALbqBD0BAAAA&ccb=7-5&ig_cache_key=GJ2lbRuekngQGgcDAG0GjH31v95wbkULAAAB1501500j-ccb7-5&oh=00_AfzCA1vyW8w29iC0CL4GU9XLjdw2-S0XxoIJMCM5a_lFYQ&oe=69B5A33F&_nc_sid=847350\",\n            \"username\": \"javan\"\n          }\n        }\n      ]\n    }\n  },\n  \"requestId\": \"8b29d516-9c1d-4212-a133-ca27c157d2c1\"\n}\n\n请根据以上信息给出可直接运行的示例代码。")}>
      ✨ 复制给 AI
    </button>
  </div>
</div>


## OpenAPI

````yaml zh/instagram.zh.openapi.json GET /v1/instagram/fetch_user_highlights
openapi: 3.0.1
info:
  title: Instagram API 中文文档
  description: Instagram API 的中文参考文档，包含接口用途、参数说明、响应状态和示例结构。
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security:
  - JWT Bearer: []
tags: []
paths:
  /v1/instagram/fetch_user_highlights:
    get:
      tags: []
      summary: 获取用户精选
      description: 获取Instagram用户的精选故事（Highlights）列表。精选是用户保存的故事合集
      parameters:
        - name: username
          in: query
          description: 用户名（与user_id二选一）
          required: false
          example: javan
          schema:
            type: string
            example: javan
        - name: user_id
          in: query
          description: 用户ID（与username二选一）
          required: false
          example: '18527'
          schema:
            type: string
            example: '18527'
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  data:
                    count: 1
                    highlights_tray_type: DEFAULT
                    items:
                      - can_gif_quick_reply: true
                        can_react_with_avatar: false
                        can_reply: true
                        can_reshare: true
                        contains_stitched_media_blocked_by_rm: false
                        cover_media:
                          crop_rect:
                            - 0.035046728971962614
                            - 0.34706397896581953
                            - 0.9649532710280374
                            - 0.8702892199824716
                          cropped_image_version:
                            height: 150
                            url: >-
                              https://scontent-lax3-1.cdninstagram.com/v/t51.82787-15/563420830_18120888430503568_5958508023765876008_n.jpg?stp=c44.792.1194.1194a_dst-jpg_e15_s150x150_tt6&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QGESkZtffl5gGFa-i_jphOys2-IHyQ4gia-yWAqWPeCi-JE-0E2hvhpmAZPtl2RE8M&_nc_ohc=J7IfOjYBEZQQ7kNvwEZdq2A&_nc_gid=SRXzArdDf2hgbTTDQuUxnA&edm=ALbqBD0BAAAA&ccb=7-5&oh=00_Afy7rw9nNHPw-XbY6pd6GkBq_8lqtiG89Eea2JSxo--jcQ&oe=69B5774B&_nc_sid=847350
                            width: 150
                          full_image_version: null
                          id: '2546507643239612773'
                          upload_id: null
                        created_at: 1622103441
                        highlight_reel_type: DEFAULT
                        id: highlight:17927864314604086
                        is_archived: false
                        is_converted_to_clips: false
                        is_nux: false
                        is_pinned_highlight: false
                        latest_reel_media: 1633609801
                        media_count: 34
                        prefetch_count: 0
                        ranked_position: -1633611895
                        reel_type: highlight_reel
                        seen_ranked_position: -1633611895
                        title: Wallpapers
                        updated_timestamp: 1633611895
                        user:
                          account_badges: []
                          full_name: Javan Ng
                          id: '18527'
                          interop_messaging_user_fbid: 105721380825451
                          is_creator_agent_enabled: false
                          is_private: false
                          is_verified: false
                          profile_pic_id: '3459147014560655728'
                          profile_pic_url: >-
                            https://scontent-lax3-1.cdninstagram.com/v/t51.2885-19/460170653_852233457013406_8133149038171915885_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QGESkZtffl5gGFa-i_jphOys2-IHyQ4gia-yWAqWPeCi-JE-0E2hvhpmAZPtl2RE8M&_nc_ohc=T43Z_QBhAnQQ7kNvwFgAFmZ&_nc_gid=SRXzArdDf2hgbTTDQuUxnA&edm=ALbqBD0BAAAA&ccb=7-5&ig_cache_key=GJ2lbRuekngQGgcDAG0GjH31v95wbkULAAAB1501500j-ccb7-5&oh=00_AfzCA1vyW8w29iC0CL4GU9XLjdw2-S0XxoIJMCM5a_lFYQ&oe=69B5A33F&_nc_sid=847350
                          username: javan
                requestId: 8b29d516-9c1d-4212-a133-ca27c157d2c1
          headers: {}
        '400':
          description: 请求参数错误，请检查必填字段和参数格式
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: 鉴权失败，请检查 Authorization Header 中的 Bearer Token 或 API Key 是否有效
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: 账户余额或额度不足
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: 请求过于频繁，已触发限流
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: 服务器内部错误，请稍后重试
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/instagram/fetch_user_highlights?username=javan&user_id=18527' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/instagram/fetch_user_highlights',
                params={"username": "javan", "user_id": "18527"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"username": "javan", "user_id":
            "18527"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/instagram/fetch_user_highlights?${params}`,
            {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        接口鉴权凭证。请在请求 Header 中传入 `Authorization: Bearer <YOUR_API_KEY>`。
        可在 [Dashboard](https://keyapi.ai/app/dashboard) 获取你的 API Key。

````