API Reference / Endpoints

Get Landing Page

Returns the structured owner view of the waitlist's landing page: status, copy fields, theme, SEO, the live URL (once published), and analytics. Available on every plan with an account API key.

Endpoint Details

URL: https://waitlister.me/api/v1/waitlist/{waitlistKey}/landing-page
Method: GET

Request

Example Request

bash

curl "https://waitlister.me/api/v1/waitlist/WAITLIST_KEY/landing-page" \
  -H "X-Api-Key: wl_acct_your-account-api-key"

Response

Success Response `200`

json

{
  "success": true,
  "data": {
    "landing_page": {
      "id": "aBcDeFgH123",
      "page_type": "standard",
      "status": "published",
      "headline": "Join the beta",
      "description": "Early access for the first 100 signups.",
      "button_text": "Get early access",
      "collect_name": true,
      "collect_phone": false,
      "background": { "type": "color", "value": "#0F172A" },
      "theme": "dark",
      "seo": {
        "title": "My Product — join the waitlist",
        "description": null,
        "keywords": [],
        "og_title": null,
        "og_description": null
      },
      "hosted_page_url": "https://waitlister.me/p/my-product",
      "analytics": { "views": 1240, "sign_ups": 87 }
    }
  }
}

Field Notes

Field	Description
`page_type`	`standard` (structured fields / drag-and-drop) or `ai` (AI builder)
`status`	`draft`, `published`, or `unpublished`
`hosted_page_url`	`null` until the page is published
`ai`	Present on AI pages only: `{ credits_remaining, last_generated_at }`

On AI pages, headline/description come from the generated page's metadata and button_text/collect_*/background are null (that content lives inside the generated page — see the 409 rule).

Error Responses

Status Code	Description
`401`	Missing or invalid API key / waitlist key
`404`	No landing page yet — create one first
`429`	Rate limit exceeded (30/min; 60/min on Growth+)
`503`	The landing-page API is temporarily disabled