Look up podcasts by external platform identifier

Resolves one or more external platform identifiers (Apple Podcasts collection IDs, Spotify show IDs, YouTube channel IDs, …) — or RSS feed URLs via platform=rss — to Particle podcasts. Pass platform once and a comma-separated list of identifiers (up to 100 per call). Each result echoes the input identifier alongside the matched podcast; unresolved identifiers omit the podcast field entirely so bulk callers can correlate inputs and outputs by key presence without doing a separate join. Use this when you already hold platform-native IDs and want a deterministic mapping; for fuzzy name search use GET /v1/podcasts/search.

GET /v1/podcasts/lookup

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/lookup?platform=apple&identifier=1535809341%2C1200361736"

200

{
  "results": [
    {
      "identifier": "<string>",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "best_rank": {
          "captured_at": "2023-11-07T05:31:56Z",
          "chart_type": "top_podcasts",
          "rank": 123,
          "source": "apple",
          "category_slug": "<string>",
          "country": "<string>"
        },
        "image_url": "<string>",
        "popularity": 123,
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>"
        },
        "slug": "<string>"
      }
    }
  ]
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Query Parameters

platform · string · required

External platform slug (e.g. 'apple', 'spotify', 'youtube'). Must be one of the slugs reported on /v1/podcasts/{id}/external-links responses, or one of the in-house aliases: 'itunes' (alias for 'apple') and 'rss' (match against the canonical podcast feed URL).

Example:

"apple"

identifier · string[] | null · required

One or more platform-native identifiers to resolve. Pass a comma-separated list to look up many at once (max 100 per call).

Required array length: 1 - 100 elements

Example:

["1535809341", "1200361736"]

Response

200

application/json

OK

results · object[] | null · required

One result per unique input identifier, in request order

Show child attributes