Buttondown logo

Listing external feeds

Use the /external_feeds endpoint to list all of your external feeds. External feeds connect an RSS feed to your newsletter to automatically import posts from another site or platform.

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/external_feeds"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "results": [
        {
            "id": "rss_0k28edc3fw896bp4mrhc535z5k",
            "creation_date": "2020-09-29T00:00:00+00:00",
            "last_checked_date": null,
            "status": "active",
            "behavior": "draft",
            "cadence": "daily",
            "cadence_metadata": {},
            "filters": {
                "filters": [],
                "groups": [],
                "predicate": "and"
            },
            "url": "https://example.com/feed",
            "subject": "New post: {{ item.title }}",
            "body": "I just published a new post: {{ item.url }}",
            "label": "Basic external feed",
            "metadata": {},
            "skip_old_items": true
        }
    ],
    "count": 1
}