Developer FAQ
Answers for the current limited-preview platform.
Is the API public?
It is currently an approved limited preview; public self-service access is coming later.
Do I need a key?
Developer access uses a scoped et_live_ or et_test_ key.
What is the base URL?
https://episodetime.com/api/v1
Are there rate limits?
Yes: the current free plan is 120 requests/minute and 10,000/day, plus bounded page sizes.
Can I use data commercially?
Commercial use and provider licensing are under review; contact EpisodeTime before launch.
Can I cache responses?
Yes, for public metadata where appropriate; respect HTTP cache headers and updated timestamps.
How do I report incorrect data?
Use the public show/person contribution flow or contact EpisodeTime.
Will v1 change?
Additive compatible changes may occur; breaking changes require deprecation or a future version.
How do webhooks work?
They are gated beta, HMAC-signed, retried, and delivered at least once.