3D Print Search API

Search 3D models across Thingiverse and Printables with a single API call. The only cross-platform 3D printing model aggregator on RapidAPI.

原始信息汇总

3D Print Search API 数据集概述

基本信息

• API名称：3D Print Search API
• 提供商：camazotz
• 类别：Search
• 状态：Freemium
• 当前版本：1.0.0

定价方案

• BASIC：$0.00 / 月
• PRO：Tier based
• 免费额度：每月前100次请求免费
• 超出免费额度后的阶梯定价：
  • 第101至10,000次请求：$0.002 / 次
  • 第10,001至100,000+次请求：$0.001 / 次
• 速率限制：30 次请求/分钟
• 注意：该API免费使用，但有限制为每分钟1次请求。

核心功能描述

该API通过单一、一致的REST接口，提供对Thingiverse和Printables这两个最大的3D模型存储库的统一访问。它消除了为每个平台构建和维护独立集成的需要。

主要特性

• 双平台单次请求：可同时搜索Thingiverse和Printables，或通过筛选参数定位特定平台。
• 标准化响应模式：无论来源平台如何，每个模型都返回相同的字段（如标题、描述、创建者、图像、下载URL、点赞数、下载次数和时间戳）。
• 搜索与发现：支持跨平台全文搜索，并提供排序和分页功能。
• 模型详情端点：可获取完整的模型信息，包括文件、标签和平台特定属性。
• 部分故障恢复能力：平台错误会按平台报告，且不会抑制来自健康平台的结果。
• 搜索元数据：每个响应都包含查询、结果总数、搜索时间（毫秒）和时间戳，便于调试。
• 无认证复杂性：认证完全通过RapidAPI处理，无需Thingiverse OAuth令牌或平台特定的API密钥。

目标受众与用例

受众	用例
3D打印应用	构建跨平台模型搜索，无需集成多个API
创客社区平台	从两个主要存储库展示流行和热门模型
打印农场运营商	以编程方式搜索模型以构建精选打印队列
电子商务平台	从最大的模型库中获取可打印的产品设计和零件
教育工具	帮助学生和教育工作者发现用于STEM项目的3D模型

快速开始示例

• 健康检查（无需认证）

  curl https://3dprint-api.p.rapidapi.com/health

• 跨所有平台搜索

  curl "https://3dprint-api.p.rapidapi.com/search?q=raspberry+pi+case&per_page=10" -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" -H "X-RapidAPI-Host: 3dprint-api.p.rapidapi.com"

• 获取模型详情

  curl "https://3dprint-api.p.rapidapi.com/models/thingiverse/12345" -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" -H "X-RapidAPI-Host: 3dprint-api.p.rapidapi.com"

端点概览

• Search
  • GET /searchModels
• Utility
  • GET /categories

附加信息

• API参考：完整的端点文档（包括所有参数、响应模式和状态码）请参阅OpenAPI规范。
• 长期描述：该API是唯一的跨平台3D模型搜索API，为需要访问Thingiverse和Printables的开发者解决了集成成本障碍。适用于3D打印应用、创客社区和教育工具。