beehiiv Developer Documentation

import requests
url = "https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/advertisement_opportunities"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "advertiser_name": "beehiiv",
      "payout_rate": "$3.00/click",
      "advertisement_kind": "without logo",
      "send_by_window_start_at": 1772562345,
      "send_by_window_end_at": 1772994359
    },
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "advertiser_name": "Google",
      "payout_rate": "$2.00/1k opens",
      "advertisement_kind": "with logo",
      "send_by_window_start_at": 1772562345,
      "send_by_window_end_at": 1772994359
    }
  ],
  "total_results": 2
}

Retrieve a list of accepted advertisement opportunities for the publication.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

Response

datalist of objects

A list of post templates available for this publication.

total_resultsinteger

The total number of results from all pages.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error