beehiiv Developer Documentation

{
  "offers": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "payout_model": "per_click",
      "payout_per_click": "$3.00",
      "payout_per_mille": "$0.00",
      "estimated_payout": "$300.00",
      "campaign": {
        "name": "World Cup",
        "message_to_publisher": "Run this campaign in an upcoming post.",
        "promoted_item": "product",
        "promoted_item_other": null
      },
      "advertiser": {
        "name": "Kalshi",
        "logo_url": "https://example.com/logo.png",
        "description": "Prediction markets.",
        "url": "https://kalshi.com"
      },
      "send_by": "2026-07-31T00:00:00Z"
    }
  ]
}

Currently in beta

This feature is currently in beta and the API is subject to change.

Retrieve a list of ad offers available for the publication.

<Note title="Currently in beta" icon="b"> This feature is currently in beta and the API is subject to change.<br/> </Note> Retrieve a list of ad offers available 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

Query parameters

requested_fromstringOptional

A source identifier for where the offers request originated.

Response

offerslist of objects

A list of ad offers available for this publication.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

$	curl https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/ad_network/offers \
>	-H "Authorization: Bearer <token>"