Jamwidgets
← Back to docs

API Reference

REST API for building custom integrations.

Authentication

All requests require your site's public site key in the X-Jamwidgets-Key header.

curl https://jamwidgets.com/api/v1/comments/my-page \
  -H "X-Jamwidgets-Key: your-site-key"

Base URL

https://jamwidgets.com/api/v1

Endpoints

Site

GET
/site

Site name, slug, and showPoweredBy, which is true when the plan requires the footer

Comments

GET
/comments/{pageId}

List comments for a page

POST
/comments/{pageId}

Create a new comment

Reactions

GET
/reactions/{pageId}

Get reaction counts for a page

POST
/reactions/{pageId}

Add a reaction

DELETE
/reactions/{pageId}

Remove a reaction

Forms

POST
/forms/{slug}/submit

Submit form data

Subscriptions

POST
/subscribe

Subscribe an email address

GETPOST
/subscribe/confirm/{token}

Confirm subscription

GETPOST
/unsubscribe/{token}

Unsubscribe

Waitlist

POST
/waitlist

Join the waitlist

Feedback

POST
/feedback

Submit feedback

Polls

GET
/polls/{slug}

Get poll data

POST
/polls/{slug}/vote

Vote on a poll

Views

GET
/views/{pageId}

Get view counts

POST
/views/{pageId}

Record a view

POST
/e

Record a pageview for analytics (no cookies). Body: { "path": "/post", "sessionId": "optional" }; returns 204

Announcements

GET
/announcements

List active announcements

POST
/announcements/{id}/dismiss

Dismiss an announcement

Posts

GET
/posts

List published posts

GET
/posts/{slug}

Get a single post

Galleries

GET
/galleries

List published galleries

GET
/galleries/{slug}

Get a gallery; add ?tag=portraits to filter photos

GET
/galleries/{slug}/random

Get a random or seeded photo

CORS & Origin Validation

You can configure allowed origins for your site in the dashboard. If set, requests must include a valid Origin header.

Leave allowed origins empty to accept requests from any origin.