SocialPlatform secret

Podcast Index

podcastindex.org

Podcast Index API provider for podcast and episode discovery.

Tier: 🥉 Bronze
Reward: ₩50,000
Auth: Platform secret
Operations: 3
Working now: 0 contributors
Status: Open

Scope

Build against the Podcast Index API with signed requests using X-Auth-Key, X-Auth-Date, and an Authorization header that carries the SHA1 signature. The provider should support search by term, podcast lookup by feed id, and episode lookup by feed id, returning feed and item fields from the documented JSON payloads.

Expected operations

search-podcastsSearch podcastsreadDifficulty: medium

Search Podcast Index by free-text term and surface matching feeds with signed requests. Backed by the Podcast Index API.

Inputs

querystringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Free-text search term for podcast discovery.

Outputs

feedsidtitleurlauthorartwork

Acceptance

Returns a feeds array for the requested term and each feed object exposes id, title, url, author, and artwork fields.
Rejects unsigned requests or requests missing the required auth headers.
Filters results to podcast metadata rather than episode-level items.

Auth required for this operation.

get-podcast-by-feed-idGet podcast by feed idreadDifficulty: medium

Fetch a single podcast record by feed id and return the canonical feed object. Backed by the Podcast Index API.

Inputs

idstringrequired
Podcast Index feed id.
75075

Outputs

feedfeedsidtitleurlauthor

get-episodes-by-feed-idGet episodes by feed idreadDifficulty: medium

List episodes for a feed id and expose publication timestamps and enclosure URLs for playback or indexing. Backed by the Podcast Index API.

Inputs

idstringrequired
Podcast Index feed id.
75075

Outputs

itemstitleenclosure_urldate_publishedidfeed_id

Acceptance

Returns the podcast feed associated with the supplied feed id.
Includes the documented feed metadata fields such as title, url, author, and artwork when present.
Fails closed when the feed id is absent or the signature headers do not validate.

Auth required for this operation.

Acceptance

Returns an items array for the requested feed id and each item includes title, enclosure_url, and date_published when available.
Preserves episode-level records instead of collapsing them into the parent feed object.
Requires valid Podcast Index authentication headers and rejects missing signatures.

Auth required for this operation.