Gift Ideas

Provides links to potential gift idea based on age, sex, and interests

原始信息汇总

Gift Ideas API 概述

基本信息

• API名称：Gift Ideas
• API提供者：DevTimeApi
• 类别：eCommerce, Gift Ideas
• 当前版本：v1
• 订阅方案：
  • BASIC：$0.00 / mo
  • PRO：$3.00 / mo
  • ULTRA：$20.00 / mo
  • MEGA：$80.00 / mo

性能指标

• 受欢迎程度：8.7
• 服务级别：100%
• 延迟：5702ms
• 测试覆盖率：78%

功能描述

提供基于年龄、性别和兴趣的潜在礼物创意链接，并可选择为每个创意添加首个亚马逊产品链接。

端点详情

POST /gift-ideas

生成礼物创意。

请求体： json { "age": 25, "gender": "female", "interests": ["yoga", "cooking", "reading"] }

响应示例： json { "age": 25, "gender": "female", "interests": ["yoga","cooking","reading"], "model": "gpt-4.1-mini", "ideas": [ {"title": "Premium Yoga Mat", "why": "Better grip and comfort."}, {"title": "Cookbook by a Celebrity Chef", "why": "Inspires new recipes."} ] }

POST /gift-ideas-with-amazon

生成礼物创意并为每个项目添加亚马逊链接。

请求体： json { "age": 25, "gender": "female", "interests": ["yoga", "cooking", "reading"] }

响应示例： json { "age": 25, "gender": "female", "interests": ["yoga","cooking","reading"], "model": "gpt-4.1-mini", "ideas": [ { "title": "Premium Yoga Mat", "why": "Better grip and comfort.", "amazon_url": "https://www.amazon.com/dp/EXAMPLEASIN" } ] }

POST /find-amazon-link

根据产品名称/查询返回首个亚马逊产品链接。

请求体： json { "query": "Pour-over coffee maker", "country_code": "us" }

响应示例： json { "found": true, "url": "https://www.amazon.com/dp/EXAMPLEASIN", "source": "serpapi", "title": "Hario V60 Ceramic Pour Over Coffee Dripper", "asin": "EXAMPLEASIN" }

GET /health

健康检查端点。

技术实现

• 创意通过服务器上的OpenAI生成
• 亚马逊链接通过SerpAPI的亚马逊引擎查找

适用场景

• 礼物推荐小工具和落地页
• 电子商务助手和礼宾服务
• 季节性礼物指南（节日、生日、纪念日）

错误代码

• 400：无效请求体（缺少/无效字段）
• 401：缺少/无效的X-API-Key
• 502：上游SerpAPI错误（亚马逊搜索）
• 500：常规服务器错误

请求限制与可靠性

• 响应时间取决于OpenAI和SerpAPI的往返时间
• 如果未找到确切产品，相关端点将回退到标准亚马逊搜索URL