scaleGlobal
收藏scaleGlobal API 数据集概述
基本信息
- API名称: scaleGlobal
- 类别: Business Software
- 提供者: Sumalya
- 订阅者数量: 2
- 当前版本: v1
- 流行度评分: 8.9
- 服务等级: 100%
- 延迟: 5022ms
- 测试覆盖率: 100%
订阅计划与定价
- BASIC: $0.00 / 月
- PRO: $9.00 / 月
- ULTRA: $29.00 / 月
- MEGA: $79.00 / 月
API 核心功能概述
名称: Global Pricing API 定位: 面向全球SaaS公司的机构级市场情报API，用于优化国际定价、扩张和风险管理。 核心功能: 一个复杂的定价推荐引擎，帮助企业优化跨国际市场的订阅定价。
主要特性
- 基于购买力平价（PPP）的价格计算: 根据当地购买力自动调整价格。
- 多频率支持: 处理月度、周度和年度计费周期。
- 智能货币转换: 集成实时汇率以实现准确的本地定价。
- 工资因素分析: 结合当地工资数据以微调推荐。
- 营销优化取整: 实施特定国家的“美观定价”（例如，₹1499 而非 ₹1500）。
- 自动价格封顶: 通过内置的底价和上限防止极端价格变动。
- 实时验证: 使用Zod模式进行全面的输入验证。
端点详情
POST /api/generate-pricing
根据您的主市场价格为多个国家生成本地化的定价建议。
请求体示例
json { "basePrice": 29.99, "baseCurrency": "USD", "homeCountry": "US", "billingFrequency": "monthly", "annualDiscountPercent": 20 }
请求参数
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
basePrice |
number | ✅ | 您的主市场月度价格 |
baseCurrency |
string | ✅ | ISO货币代码（例如 "USD", "EUR"） |
homeCountry |
string | ✅ | 两位国家代码（例如 "US", "GB"） |
billingFrequency |
string | ❌ | "monthly", "weekly", 或 "annually"（默认："monthly"） |
annualDiscountPercent |
number | ❌ | 年度计划的折扣百分比（0-100） |
成功响应（200 OK）示例
json { "recommendations": [ { "countryName": "United States", "countryCode": "US", "recommendedPrice": "$29.99", "justification": "This is the base monthly price you provided for your home market." }, { "countryName": "India", "countryCode": "IN", "recommendedPrice": "₹499", "justification": "Adjusted from your base price using Purchasing Power Parity (PPP), local wage data, and currency conversion for a monthly billing cycle." } ] }
错误响应
- 400 Bad Request: 请求体中缺少
basePrice、baseCurrency或homeCountry。 - 400 Invalid Input: 定价模型的输入无效（例如类型错误）。
- 500 Server Error: 处理请求失败（例如汇率不可用）。
定价算法详情
计算方法
- 基础转换: 将主市场月度价格转换为美元。
- PPP调整: 乘以目标国/本国人均GDP购买力平价比率。
- 数字商品溢价: 对数字产品应用2.5倍乘数。
- 工资因素: 基于当地平均工资比率进行调整（限制在0.75-1.25之间）。
- 价格封顶: 确保价格保持在基础美元价格的20%到150%之间。
- 货币转换: 转换回当地货币。
- 频率调整: 为周度/年度计费进行缩放。
- 营销取整: 应用特定国家的“美观定价”规则。
特定国家取整规则
- 印度（INR）:
-
1000: 取整到最接近的100，然后减1（例如，1499）。
-
100: 取整到最接近的10，然后减1（例如，199）。
- 默认: 取整到整数，然后减1（例如，49）。
-
- 其他货币:
-
20: 取整到最接近的整数，然后减0.01（例如，24.99）。
-
1: 向上取整到整数，然后减0.01（例如，4.99）。
- <0.5: 设置为0.99。
-
支持的国家
API支持 countriesData 数据集中包含的所有国家，每个国家数据包括：
- 人均GDP（购买力平价）
- 平均月工资
- 消费者价格指数
- 货币代码
- 汇率数据
使用场景
- SaaS公司: 在新的国际市场推出产品。
- 数字产品所有者: 优化全球定价策略。
- 订阅服务: 设置特定区域的定期账单金额。
- 市场扩张: 确定新兴市场的进入定价。
错误处理
API对以下情况实施全面的错误处理：
- 无效的货币代码
- 汇率缺失
- 不支持的国家代码
- JSON请求格式错误
- 类型验证错误
最佳实践
- 始终提供准确的本国数据以获得更好的推荐。
- 使用
annualDiscountPercent参数获得更现实的年度定价。 - 使用多种计费频率进行测试以找到最优定价模型。
- 查看理由以理解价格调整。
- 考虑经济因素之外的当地市场条件。
技术栈
- 框架: Next.js API Routes
- 验证: Zod 模式验证
- 数据源: 购买力平价指数、工资数据、实时汇率
- 响应格式: 带有货币格式化价格的JSON
示例实现
cURL
bash curl -X POST https://yourapi.com/api/route -H "Content-Type: application/json" -d { "basePrice": 19.99, "baseCurrency": "EUR", "homeCountry": "DE", "billingFrequency": "annually", "annualDiscountPercent": 15 }
JavaScript
javascript const response = await fetch(https://yourapi.com/api/route, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ basePrice: 19.99, baseCurrency: EUR, homeCountry: DE, billingFrequency: annually, annualDiscountPercent: 15 }) }); const data = await response.json(); console.log(data.recommendations);
