Developer API

Why it matters

From the problem to what SEOmise does

The problem

Your data stuck in one screen

Your team and your clients work in other tools: dashboards, CRMs and websites. Copying scores across by hand is slow, and the copies go out of date.

What Developer API does

Use your SEO data in your own systems, dashboards and websites

Read-only REST API. Sites, audit scores and history, crawled pages, issues, the technical report, backlinks, authority and Google Business Profile health.
Keys with limits. Each key gets only the scopes you choose, with an optional expiry date and a list of allowed IP addresses. Rotate or revoke a key at any time.
Rate limits you can see. A per-minute limit from your plan, with limit headers on every answer and a 30-day usage chart.

How it works

Four steps, start to finish

Create a keyChoose what the key may read. The key is shown once, and SEOmise keeps only a fingerprint of it.
Call the APISend the key with each request. Answers are JSON, and an OpenAPI 3.1 description lists every endpoint.
Add webhooksPick the events you want, such as a finished scan or a new Google review. Each delivery is signed.
Embed widgetsShow a live score card on the websites you allow.

Features

What you get with Developer API

Read-only REST API

Sites, audit scores and history, crawled pages, issues, the technical report, backlinks, authority and Google Business Profile health.

Keys with limits

Each key gets only the scopes you choose, with an optional expiry date and a list of allowed IP addresses. Rotate or revoke a key at any time.

Rate limits you can see

A per-minute limit from your plan, with limit headers on every answer and a 30-day usage chart.

Signed webhooks

Events for finished and failed scans, new and lost backlinks, link orders, new Google reviews and audit widget leads, signed with HMAC-SHA256.

Retries and a delivery log

A failed delivery is tried again after 1, 2, 4, 8 and 16 minutes. Every delivery is logged and can be sent again.

Embeddable score widgets

Audit score, issues summary, backlink summary, authority score and Business Profile health, in a light, dark or automatic theme.

Safe by design

Webhooks only go to public https addresses, checked again at every delivery. Widgets can only be shown on the domains you list.

OpenAPI description

Import it into Postman, Insomnia or a code generator, and start from the quick start in the app.

What it needs

No surprises after you sign up

Turn a card over for the detail.

API access in your plan

For keys, the API and webhooks.

Embeds in your plan

For the score widgets.

The module behind the data

Website health for audits and issues, Backlinks for link data, and Google Business Profile for local data.

An owner or admin

Only owners and admins can create keys, webhooks and widgets.

Every platform

Whatever your site runs on

What Developer API does on each kind of website, from SEOmise's site connectors to step-by-step guidance.

WordPress

WordPress and WooCommerce

Fully supported

The WordPress connector adds a shortcode and an "SEOmise widget" block for score widgets. The API and webhooks do not depend on your site.

Laravel

Sites built on Laravel

Fully supported

Add the widget code to a Blade view. The API and webhooks do not depend on your site.

Any PHP site

Custom PHP, CodeIgniter, Symfony, Drupal, Joomla

Fully supported

Add the widget code to any page. The API and webhooks do not depend on your site.

Every other platform

Shopify, Wix, Squarespace, Webflow, static sites and the rest

Fully supported

Any website that accepts HTML can show a widget, by script or by plain frame. The API works from any system.

About the site connectors

Where Developer API is included

Developer API is not part of a public plan at the moment.

See pricing

Not sure it fits?

Ask Mise, our assistant, in the help centre, or book a call and we will show you Developer API on a site like yours.

Book a demo Ask Mise

Questions

Developer API: common questions

Can the API change my website?

No. Every data scope is read-only. The only thing a key can change is the workspace's webhook endpoints, and only when it has the webhooks scope.

How do I know a webhook really came from SEOmise?

Each request carries a SEOmise-Signature header with a timestamp and an HMAC-SHA256 of the timestamp and the raw body, made with your endpoint's secret. Check it, and reject old timestamps.

What happens if my endpoint is down?

Each delivery is tried up to 6 times over about half an hour. After 15 failed attempts in a row the endpoint is switched off and the workspace owners get an e-mail. Switch it back on when it is fixed.

Can I show a widget on any website?

Yes, on the domains you list for it. Use the script, which sets its own height, or a plain frame. WordPress sites can also use the connector's shortcode or block.

How fresh is the data?

The API reads your latest scans and checks. Widget pages are cached for 5 minutes.

Do the scores predict rankings?

No. They are SEOmise's measurements of your sites, not ranking guarantees.

Which plans include Developer API?

Plans and add-ons are on the pricing page. If Developer API is not listed there yet, ask us how to get it.

Works well with

Related modules

Try Developer API on your own site

Add your site; your first scan becomes your Day 0 baseline. Nothing is bought or published without your approval.

Join the beta Book a demo Ask Mise

No ranking guarantees: just clear work, with the evidence.