PodcastIndex

PodcastIndex Apple Replacement API

The Apple Replacement API from PodcastIndex — 2 operation(s) for apple replacement.

GitHub OpenAPI

Operations 2

GET /lookup Lookup #

Documentation

📖
Documentation
https://podcastindex-org.github.io/docs-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/podcastindex/refs/heads/main/openapi/podcastindex-apple-replacement-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/podcastindex-apple-replacement-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

podcastindex-apple-replacement-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.12.1
  title: PodcastIndex.org Apple Replacement API
  termsOfService: https://github.com/Podcastindex-org/legal/blob/main/TermsOfService.md
  contact:
    email: info@podcastindex.org
    url: https://podcastindex.org/
  license:
    name: MIT
    url: https://github.com/Podcastindex-org/docs-api/blob/master/LICENSE
  x-logo:
    url: logo.svg
    href: /
  description: Download the openapi spec in json or yaml format.
servers:
- url: https://api.podcastindex.org/api/1.0
tags:
- name: Apple Replacement
paths:
  /search:
    get:
      tags:
      - Apple Replacement
      summary: Search
      description: 'Replaces the Apple search API but returns data from the Podcast Index database.


        Note: No API key needed for this endpoint.


        Example:


        - Apple: https://itunes.apple.com/search?media=podcast&entity=podcast&term=batman

        - PodcastIndex: https://api.podcastindex.org/search?term=batman'
      operationId: search
      security: []
      servers:
      - url: https://api.podcastindex.org
        description: URL for Apple Replacement endpoints
      parameters:
      - $ref: '#/components/parameters/term_itunes'
      - $ref: '#/components/parameters/pretty'
      responses:
        '200':
          $ref: '#/components/responses/itunes_replacement'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
  /lookup:
    get:
      tags:
      - Apple Replacement
      summary: Lookup
      description: 'Replaces the Apple podcast lookup API but returns data from the Podcast Index database.


        Note: No API key needed for this endpoint.


        Example:


        - Apple: https://itunes.apple.com/lookup?media=podcast&entity=podcast&id=1636765656

        - PodcastIndex: https://api.podcastindex.org/lookup?entity=podcast&id=1636765656'
      operationId: lookup
      security: []
      servers:
      - url: https://api.podcastindex.org
        description: URL for Apple Replacement endpoints
      parameters:
      - $ref: '#/components/parameters/id_feed_podcast_itunes'
      - $ref: '#/components/parameters/entity'
      - $ref: '#/components/parameters/pretty'
      responses:
        '200':
          $ref: '#/components/responses/itunes_replacement'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
components:
  parameters:
    pretty:
      name: pretty
      in: query
      description: 'If present, makes the output “pretty” to help with debugging.



        Parameter shall not have a value

        '
      schema:
        type: boolean
      allowEmptyValue: true
    term_itunes:
      name: term
      in: query
      description: 'The term to search for

        '
      required: true
      schema:
        type: string
      example: batman
    id_feed_podcast_itunes:
      name: id
      in: query
      description: 'The iTunes Feed ID to search for

        '
      required: true
      schema:
        type: integer
      examples:
        id_only:
          value: 1441923632
          description: iTunes ID without any prefix
        prefix:
          value: id1441923632
          description: iTunes ID with optional "id" prefix
    entity:
      name: entity
      in: query
      description: 'The iTunes entity type to look in

        '
      required: true
      schema:
        type: string
        enum:
        - podcast
      example: podcast
  responses:
    '401':
      description: Not authenticated
      content:
        application/json:
          schema:
            type: string
          example: Authorization header value either not set or blank.
    itunes_replacement:
      description: Success
      content:
        application/json:
          schema:
            type: object
            properties:
              resultCount:
                $ref: '#/components/schemas/resultCount'
              results:
                $ref: '#/components/schemas/itunes_replacement_results'
    '400':
      description: Invalid request
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                $ref: '#/components/schemas/status'
              description:
                $ref: '#/components/schemas/description_response'
          example:
            status: 'false'
            description: Invalid parameters
  schemas:
    itunes_results:
      type: object
      properties:
        artistName:
          $ref: '#/components/schemas/author'
        artworkUrl100:
          $ref: '#/components/schemas/artworkUrl'
        artworkUrl30:
          $ref: '#/components/schemas/artworkUrl'
        artworkUrl60:
          $ref: '#/components/schemas/artworkUrl'
        artworkUrl600:
          $ref: '#/components/schemas/artworkUrl'
        collectionCensoredName:
          $ref: '#/components/schemas/title_feed_censored'
        collectionExplicitness:
          description: 'Indicates if the feed is marked explicit.

            '
          type: string
          enum:
          - explicit
          - cleaned
          example: cleaned
        collectionHdPrice:
          $ref: '#/components/schemas/price'
        collectionId:
          $ref: '#/components/schemas/collectionId'
        collectionName:
          $ref: '#/components/schemas/title_feed'
        collectionPrice:
          $ref: '#/components/schemas/price'
        collectionViewUrl:
          $ref: '#/components/schemas/view_url'
        contentAdvisoryRating:
          description: 'Indicates if the feed is explicit or clean.

            '
          type: string
          enum:
          - Clean
          - Explicit
          example: Clean
        country:
          description: 'The country the feed is from.



            Note: Right now, always returns "USA"

            '
          type: string
          example: USA
        currency:
          description: 'Currency `*Price` value is in.



            Note: will always return "USD"

            '
          type: string
          example: USD
        feedUrl:
          $ref: '#/components/schemas/url_feed'
        genreIds:
          description: 'List of ids representing the names in the `genres`.



            Values are determined by the IDs used in the url of genres on https://podcasts.apple.com/us/genre/podcasts/id26

            '
          type: array
          items:
            type: integer
          example:
          - 1309
          - 26
        genres:
          description: 'List of genre names.

            '
          type: array
          items:
            type: string
          example:
          - TV & Film
          - Podcats
        kind:
          description: 'The kind of content returned by the search request.



            Note: will always return "podcast"

            '
          type: string
          example: podcast
        primaryGenreName:
          description: 'The primary genre name.

            '
          type: string
          example: ''
        releaseDate:
          description: 'Date and time of request

            '
          type: string
          example: 2022-10-03T02:17:03-0500
        trackCensoredName:
          $ref: '#/components/schemas/title_feed_censored'
        trackCount:
          description: 'Number of episodes in feed

            '
          type: integer
          example: 12
        trackExplicitness:
          description: 'Indicates if the episode is marked explicit.

            '
          type: string
          enum:
          - explicit
          - cleaned
          example: cleaned
        trackHdPrice:
          $ref: '#/components/schemas/price'
        trackHdRentalPrice:
          $ref: '#/components/schemas/price'
        trackId:
          $ref: '#/components/schemas/collectionId'
        trackName:
          $ref: '#/components/schemas/title_feed'
        trackPrice:
          $ref: '#/components/schemas/price'
        trackRentalPrice:
          $ref: '#/components/schemas/price'
        trackViewUrl:
          $ref: '#/components/schemas/view_url'
        wrapperType:
          description: 'The name of the object returned by the search request.



            Note: will always return "track"

            '
          type: string
          example: track
    itunes_replacement_results:
      description: 'List of feeds matching request

        '
      type: array
      items:
        $ref: '#/components/schemas/itunes_results'
    collectionId:
      description: 'The iTunes Feed ID

        '
      type: integer
      example: 1441923632
    price:
      description: 'Price of content. Will always return 0.

        '
      type: integer
      example: 0
    status:
      description: 'Indicates API request status

        '
      type: string
      enum:
      - 'true'
      - 'false'
      example: 'true'
    title_feed:
      description: 'Name of the feed

        '
      type: string
      example: Batman University
    resultCount:
      description: 'Number of items returned in request

        '
      type: integer
      example: 1
    url_feed:
      description: 'Current feed URL

        '
      type: string
      format: URL
      example: https://feeds.theincomparable.com/batmanuniversity
    view_url:
      description: 'The URL for viewing the feed on the Apple website.

        '
      type: string
      example: https://podcasts.apple.com/us/podcast/*/id1441923632?uo=4
    author:
      description: 'The channel-level author element.



        Usually iTunes specific, but could be from another namespace if not present.

        '
      type: string
      example: Tony Sindelar
    artworkUrl:
      description: 'A URL for the artwork associated with the returned media type.



        Note: Apple returns the image sized to value in the field name but the PodcastIndex returns the original image

        specified in the feed.

        '
      type: string
      example: https://www.theincomparable.com/imgs/logos/logo-batmanuniversity-3x.jpg
    description_response:
      description: 'Description of the response

        '
      type: string
      example: Found matching feed
    title_feed_censored:
      description: 'The name of the feed.



        Note: Apple censors the name but PodcastIndex does not.

        '
      type: string
      example: Batman University
  securitySchemes:
    User-Agent:
      type: apiKey
      in: header
      name: User-Agent
      description: 'Please identify the system/product you are using to make this request.



        *Example*: `SuperPodcastPlayer/1.3`

        '
    API-Key:
      type: apiKey
      in: header
      name: X-Auth-Key
      description: 'Your API key string



        *Example*: `UXKCGDSYGUUEVQJSYDZH`

        '
    Date:
      type: apiKey
      in: header
      name: X-Auth-Date
      description: 'The current UTC unix epoch time as a string. 3 minute window.



        This value is an integer; round down if needed. The value shall not include a decimal point.



        Value generated should match the value shown on the website https://www.epochconverter.com/.



        *Example*: `1613713388`

        '
    Authorization:
      type: apiKey
      in: header
      name: Authorization
      description: "A SHA-1 hash of the `X-Auth-Key`, the corresponding secret and the `X-Auth-Date` value concatenated as a string.\nThe resulting hash should be encoded as a hexadecimal value, two digits per byte, using lower case letters for\nthe hex digits \"a\" through \"f\".\n\n\nThe Authorization header is computed with something like this (pseudo-code):\n\n    authHeader = sha1(apiKey+apiSecret+unixTime)\n\nExample value, uses example values of `X-Auth-Key` and `X-Auth-Date` and an api secret of\n`yzJe2eE7XV-3eY576dyRZ6wXyAbndh6LUrCZ8KN|`\n\n\n*Example*: `UXKCGDSYGUUEVQJSYDZH`\n"