Buttondown logo

Listing external feed items

Use the /external_feeds/{id}/items endpoint to list all of the items for a given external feed, including their publish date and whether they've been imported as emails.

New to external feeds? See RSS-to-email for more on what they are and how they work.

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/external_feeds/{id}/items"
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": "rssi_0k28edc3fw896bp4mrhc535z5k",
            "creation_date": "2020-09-29T00:00:00+00:00",
            "status": "processed",
            "url": "https://example.com/blog/post-1",
            "publish_date": "2020-09-29T00:00:00+00:00",
            "title": "Example Blog Post",
            "description": "This is an example blog post description.",
            "content": "<p>This is the full content of the blog post.</p>",
            "author": "John Doe",
            "email_id": "em_0k28edc3fw896bp4mrhc535z5k",
            "email": null
        }
    ],
    "count": 1
}

Path parameters

Consult the Filtering documentation for more information on how to filter and sort your requests.

expand

Type
array
Description

If provided, expand the given field.

page

Type
string
Description

The page number of the paginated response.