Skip to Content

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

RequestWhat it does
GET /api/v1/reviewsYour reviews, newest first. Filter by replyStatus or sentiment.
GET /api/v1/platesYour plates, newest first, or one plate with ?id=.
POST /api/v1/plates/{id}/repointPoint 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.

EventWhen it is sent
review.postedA new review arrives, after it is rated and checked.
review.repliedA reply to a review is recorded in TapStellar.
plate.repointedA plate's destination changes.
plate.link_health_failedA 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

Still need help?

Our team answers around the clock, every day.

Chat with us 24/7

© 2026 Quantum AI WebApps Digital LLC · tapstellar.com

On this page