API and webhooks
Read your reviews and plates from your own tools, record review requests, and get told when something happens. Pro and Agency.
The TapStellar API lets your own tools read your reviews and plates, and webhooks tell those tools when something happens. It is included on the Pro and Agency plans. On other plans, requests are refused with a message to upgrade.
Who can do this
Only owners and admins can create or revoke keys and webhook endpoints. Everyone else can see what exists.
Create an API key
Open API and webhooks
Open API + webhooks in the menu.
Name the key
Under API keys, type a name that tells you where it is used, for example "Zapier", then choose Create key. You can have 10 active keys.
Copy it now
The key is shown once. Copy it and keep it somewhere safe. We store only a scrambled form, so we cannot show it again. If you lose it, revoke it and create a new one.
Treat a key like a password
Anyone with the key can read your reviews through the API. Revoke a key from the same page the moment you think it has leaked. Revoking asks you to confirm with your password or an e-mail code first.
Make a request
Send the key in an Authorization header on every request to https://app.tapstellar.com/api/v1/:
curl "https://app.tapstellar.com/api/v1/reviews?limit=10" \
-H "Authorization: Bearer YOUR_KEY"Errors always come back as JSON in the form { "error": { "code": "...", "message": "..." } }. Each key can make up to 600 requests a minute, and over that you get a rate_limited error.
What you can do
| Request | What it does |
|---|---|
GET /api/v1/reviews | Your reviews, newest first. Filter by replyStatus or sentiment. |
GET /api/v1/plates | Your plates, newest first, or one plate with ?id=. |
POST /api/v1/plates/{id}/repoint | Point a plate at a new destination_url. The change appears in the plate's Change history. |
List requests take limit (1 to 200, default 50) and cursor. To get the next page, pass the nextCursor from the last one.
The full list, with every field, is in our OpenAPI file at app.tapstellar.com/api/v1/openapi.json, which you can import into Postman or any API tool.
Webhooks
A webhook sends a small message to an address of yours when something happens.
Add an endpoint
On API + webhooks, under Webhook endpoints, enter your Endpoint address (it must start with https://), tick the Events you want and save. You can add up to 5 endpoints.
Save the signing secret
The signing secret is shown once. Use it to check that a message really came from TapStellar.
Send a test
Choose the test button on the endpoint. We send a test message and show you the result.
Every message is JSON with the event name, the time, your account and the details of what happened. It is signed in an X-TapStellar-Signature header, in the form t=<time>,v1=<signature>. The signature is an HMAC-SHA256 of the time, a full stop and the raw body, made with your signing secret. Reply with any 2xx within 10 seconds to say you got it.
| Event | When it is sent |
|---|---|
review.posted | A new review arrives, after it is rated and checked. |
review.replied | A reply to a review is recorded in TapStellar. |
plate.repointed | A plate's destination changes. |
plate.link_health_failed | A plate's destination stops working. |
A few more events cover listings, directory entries and Google posts for accounts with the Local SEO Pack. The OpenAPI file lists them all.
Good to know
- The API reads your own account only. Nothing here lets you see another business.
- The review widget uses a separate public feed that needs no key. See Review widget.
- Stuck? See Troubleshooting or chat with us at help.tapstellar.com.
Still need help?
Our team answers around the clock, every day.
© 2026 Quantum AI WebApps Digital LLC · tapstellar.com