Buttondown logo

Listing comments

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/comments"
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": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "creation_date": "2020-09-29T00:00:00+00:00",
            "email_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "subscriber_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "parent_id": null,
            "text": "This is a test comment",
            "comment_type": "subscriber",
            "annotation_data": {},
            "subscriber": null,
            "email": null
        }
    ],
    "count": 1
}

Path parameters

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

comment_type

Type
string · required
Description

If provided, only return comments of the given type.

Values
  • reviewer
  • subscriber

email_id

Type
string
Description

If provided, only return comments for the given email.

subscriber_id

Type
string
Description

If provided, only return comments for the given subscriber.

parent_id

Type
string
Description

If provided, only return comments that are replies to the given parent comment.

expand

Type
array
Description

If provided, expand the given field. (Only supported fields: 'subscriber', 'email').

ordering

Type
string
Values
  • creation_date
  • -creation_date
  • email
  • -email
  • subscriber
  • -subscriber
Buttondown logo

Listing comments

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/comments"
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": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "creation_date": "2020-09-29T00:00:00+00:00",
            "email_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "subscriber_id": "13121cd6-0dfc-424c-bb12-988b0a32fcb3",
            "parent_id": null,
            "text": "This is a test comment",
            "comment_type": "subscriber",
            "annotation_data": {},
            "subscriber": null,
            "email": null
        }
    ],
    "count": 1
}

Path parameters

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

comment_type

Type
string · required
Description

If provided, only return comments of the given type.

Values
  • reviewer
  • subscriber

email_id

Type
string
Description

If provided, only return comments for the given email.

subscriber_id

Type
string
Description

If provided, only return comments for the given subscriber.

parent_id

Type
string
Description

If provided, only return comments that are replies to the given parent comment.

expand

Type
array
Description

If provided, expand the given field. (Only supported fields: 'subscriber', 'email').

ordering

Type
string
Values
  • creation_date
  • -creation_date
  • email
  • -email
  • subscriber
  • -subscriber