openclaw-voc-skill/social-media/instagram-user-info/api-config.json

{
  "name": "instagram-user-info",
  "displayName": "Instagram 用户详情",
  "description": "根据用户名获取 Instagram 用户的完整资料，包括粉丝数、关注数、帖子数、个人简介、是否认证等。用于竞品品牌社媒画像分析、红人详情获取。",
  "category": "social-media",
  "version": "1.0.0",
  "endpoint": {
    "method": "GET",
    "url": "https://server.fmode.cn/thapi/v1/instagram/v1/fetch_user_info_by_username_v3",
    "headers": {
      "Authorization": "Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==",
      "Accept": "application/json"
    }
  },
  "parameters": {
    "type": "object",
    "required": [
      "username"
    ],
    "properties": {
      "username": {
        "type": "string",
        "description": "Instagram 用户名（不含@），如 'nestnewyork'、'paddywax'"
      }
    }
  },
  "requestTransform": {
    "queryParams": {
      "username": "{{username}}"
    }
  },
  "response": {
    "type": "object",
    "description": "用户详细资料",
    "properties": {
      "user": {
        "type": "object",
        "properties": {
          "pk": {
            "type": "string",
            "description": "用户数字 ID"
          },
          "username": {
            "type": "string",
            "description": "用户名"
          },
          "full_name": {
            "type": "string",
            "description": "显示名称"
          },
          "biography": {
            "type": "string",
            "description": "个人简介"
          },
          "follower_count": {
            "type": "integer",
            "description": "粉丝数"
          },
          "following_count": {
            "type": "integer",
            "description": "关注数"
          },
          "media_count": {
            "type": "integer",
            "description": "帖子总数"
          },
          "is_verified": {
            "type": "boolean",
            "description": "是否蓝V认证"
          },
          "is_business": {
            "type": "boolean",
            "description": "是否商业账号"
          },
          "category": {
            "type": "string",
            "description": "账号类别"
          },
          "external_url": {
            "type": "string",
            "description": "外部链接（如品牌官网）"
          },
          "profile_pic_url_hd": {
            "type": "string",
            "description": "高清头像 URL"
          }
        }
      }
    }
  },
  "notes": "返回的 pk（用户数字 ID）可用于 instagram_user_posts 接口获取帖子列表。media_count 对应报告中的帖子数（如 Paddywax 3,095 条）。",
  "usageExamples": [
    {
      "name": "获取 NEST New York IG 详情",
      "input": {
        "username": "nestnewyork"
      },
      "description": "获取 NEST New York 的 IG 粉丝数（报告中显示 144,102）、帖子数等"
    },
    {
      "name": "获取 Paddywax IG 详情",
      "input": {
        "username": "paddywax"
      },
      "description": "获取 Paddywax 的 IG 粉丝数（报告中显示 126,441）和帖子数（3,095 条）"
    },
    {
      "name": "获取 SpaRoom IG 详情",
      "input": {
        "username": "sparoom"
      },
      "description": "获取 SpaRoom 的 IG 数据（报告中显示极低存在感）"
    }
  ],
  "reportMapping": {
    "slides": [
      "竞品对标(Slide4)",
      "知识中心(Slide11)"
    ],
    "dataPoints": [
      "IG粉丝数",
      "帖子总数",
      "认证状态",
      "品牌简介",
      "外部链接"
    ]
  },
  "timeout": 15000,
  "retry": {
    "maxAttempts": 3,
    "delay": 1500,
    "backoffMultiplier": 2
  }
}