When creating an export of your Buttondown data, you can now specify two new fields to transform the shape and specificity of the data you receive:

• parameters: a dictionary of parameters to filter the data you receive.
• columns: a list of columns to include in the export.

Rather than just getting "every data point about every subscriber, ever":

import requests

url = "https://api.buttondown.com/v1/exports"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}
data = {
  "collections": [
    "subscribers"
  ]
}

response = requests.request("POST", url, headers=headers, json=data)
print(response.text)

You can, say, grab just the email address and status of every subscriber in the past week:

curl --request POST \
     --url https://api.buttondown.com/v1/exports \
     --header "Authorization: Token <your-api-key>" \
     --data '{"collections": ["subscribers"], "parameters": {"date": ["2024-12-03", null]}, "columns": ["email", "subscriber_type"]}'

(We plan on augmenting this functionality to allow pulling specific metadata fields, too, but you can't do that quite yet.)