Backtracks for Developers

# Resolving a Series

You may resolve (i.e. lookup) a series with the following call. Just provide one: a title or a source_feed_url. If the series is found, it will return information about the series.

# Resolve Series Request

POST https://api.backtracks.fm/v1/proxy/resolve HTTP/1.1
Accept: application/json
Authorization: JWT <your backtracks access token>...
Content-Type: application/json

{
    "<one of 'title', 'original_feed_url', 'unified_prefix_key'>": "<lookup value>"
}
resolve/lookup option description
title title of the series
original_feed_url URL of the source or original feed
unified_prefix_key unified_prefix_key of the series

# Resolve Request Example

POST https://api.backtracks.fm/v1/proxy/resolve HTTP/1.1
Accept: application/json
Authorization: JWT <your backtracks access token>...
Content-Type: application/json

{
    "original_feed_url": "https://example.com/feed"
}

# Resolve Series Response

HTTP/1.1 200 OK
Location: https://api.backtracks.fm/v1/proxy/resolve
Content-Type: application/hal+json; charset=utf-8

{
    "language": "en",
    "id": "abc681ba-12df-11eb-9f00-3c6aa7da28c4",
    "slug": "proxy-test",
    "title": "Test",
    "series_type_name": "episodic",
    "description": "The podcast about things.",
    "external_url": "https://www.example.com",
    "external_url_hostname": "www.example.com",
    "redirect_url": null,
    "publish_status": 1,
    "publish_status_date": "2022-10-20T14:20:56.017759+00:00",
    "artwork_url": "https://example.com/image.png",
    "subtitle": "",
    "author": "Lord of Examples",
    "managing_editor": null,
    "feed_url": "https://backtracks.fm/feed/69460c8debe54e36d",
    "original_feed_url": "https://example.com/something",
    "feed_proxy_id": "69460c8debe54e36d",
    "unified_prefix_key": "284bb44d9542447fe",
    "unified_prefix_url": "https://bktrks.co/bt/284bb44d9542447fe",
    "owner_name": "Lord of Examples",
    "owner_email": "example@exmaple.com",
    "copyright": "2022 Example",
    "explicit_str": "no",
    "is_private": false,
    "episode_limit": null,
    "itunes_app_id": null,
    "twitter_handle": null,
    "categories": [
        "<itunes:category text=\"Society &amp; Culture\" />"
    ],
    "_links": {
        "self": {
            "href": "https://api.backtracks.fm/v1/series/<series_id>"
        }
    }
}

TIP

Learn more about the unified prefix key and unified_prefix_url in here.

← Manually Sync Series →