Time Capsule API — "The Day You Were Born"

Relive any day in history. Get the top song, movie ticket prices, inflation-adjusted dollars, pop culture headlines, and generational context for any date — from the moon landing to today. Powered by Billboard, US Census Bureau, Bureau of Labor Statistics, and Box Office Mojo.

原始信息汇总

数据集概述

名称

Time Capsule API — "The Day You Were Born"

类别

娱乐（Entertainment）

简介

该API提供从1950年至今任意日期的历史快照，整合流行文化、经济和代际数据。用户可获取指定日期的Billboard Hot 100冠军歌曲、票房冠军、消费价格、通胀调整数据、文化头条、技术里程碑、时任总统以及代际背景信息。此外，支持双日期比较和随机日期发现功能。

数据来源

• Billboard Hot 100
• 美国人口普查局（US Census Bureau）
• 美国劳工统计局（Bureau of Labor Statistics）
• Box Office Mojo
• 美国国会图书馆（Library of Congress）

覆盖时间范围

1950年至今（超过70年美国历史数据）

基础URL

• https://api-gateway-production.21truescarystories.workers.dev

身份验证

所有数据端点（除API概览外）均需在请求头中携带 x-api-key，密钥通过RapidAPI获取。

可用端点

端点	方法	描述
/v1/timecapsule/snapshot/{date}	GET	获取指定日期（YYYY-MM-DD）的完整历史快照
/v1/timecapsule/today	GET	获取当前日期的快照
/v1/timecapsule/random	GET	获取随机日期的快照
/v1/timecapsule/compare	POST	比较两个日期的经济、文化和代际数据
/v1/timecapsule/test	POST	生成指定数量的随机快照用于测试
/v1/timecapsule/	GET	返回API概览（无需认证）

主要功能

• 完整日期快照：每个响应包含音乐、电影、消费价格、通胀乘数、文化头条、技术里程碑、总统和代际分类。
• 通胀调整：基于CPI数据，提供指定日期与当前日期的购买力对比。
• 代际背景：返回出生日期的代际标签（如千禧一代、Z世代）及描述。
• 双日期比较：并排展示两个日期的经济和文化对比。
• 今日快照：无需日期参数即可获取当前日期数据。
• 随机日期发现：支持“历史上的今天”等怀旧或问答功能。
• 测试样本生成：一次调用生成多个随机快照，用于开发和演示。

典型应用场景

• 个人怀旧应用（如查询生日当天的冠军歌曲、物价）
• 内容与社交应用（每日“历史上的今天”小部件、怀旧卡片）
• 教育平台（展示不同年代的通胀、工资和文化变化）
• 金融工具（通胀调整后的美元对比）
• 游戏化与问答（“猜年份”功能）
• AI与LLM代理（为时间推理提供结构化历史背景）
• 娱乐与营销（驱动怀旧营销活动）

定价与速率限制

套餐	价格	包含请求量	速率限制
免费（Free）	$0	100次/天	未指定
入门（Starter）	$9.99/月	5,000次/月	60次/分钟
专业（Pro）	$29.99/月	25,000次/月	300次/分钟
企业（Enterprise）	自定义	无限	自定义

重要说明

• 免费套餐包含快照、今日和随机端点；/compare 和 /test 端点需入门级及以上套餐。
• 日期必须为ISO 8601格式（YYYY-MM-DD），超出1950年至今范围将返回404错误。
• 超出速率限制时将返回429状态码，建议实现指数退避策略。