SEO Tools API

Optimize your site for search engines

Base URL: https://api.wemasy.nl/api
ⓘ The token stays in this browser tab only (sessionStorage) and is sent to the WEMASY API only. Don't use production tokens on shared computers.

SEO Audit

Start SEO audit

POST /services/seo/v1/seo/audit/create Auth

Kicks off an SEO audit for a URL on the project's own site (its active domain or platform subdomain). Competitor tracking uses the competitors endpoints instead.

Get SEO audit

POST /services/seo/v1/seo/audit/get Auth

Returns one audit with all per-page results inline. Use this for the report view — the SPA renders score, issue counts, and the full per-test breakdown.

List SEO audits

POST /services/seo/v1/seo/audit/list Auth

Returns project-scoped audit history, most recent first, paginated.

Compare two SEO audits (incremental diff or competitor benchmark)

POST /services/seo/v1/seo/audit/compare Auth

Export SEO audit as PDF

POST /services/seo/v1/seo/audit/export-pdf Auth

Generates a shareable PDF of the audit report and uploads it to the wemasy-analyze bucket. Returns the public URL. Idempotent — repeated calls reuse the existing PDF unless `force=true`.

Mint or rotate public share token

POST /services/seo/v1/seo/audit/share-token Auth

Cancel in-flight SEO audit

POST /services/seo/v1/seo/audit/cancel Auth

Export 404 checker report as CSV

POST /services/seo/v1/seo/audit/broken-links/export Auth

One row per broken link and page it was found on. Paid plans only; free plans get 403 with reason upgrade_required.

SEO plan of the project

POST /services/seo/v1/seo/plan Auth

Tier (free or pro), crawl limits per scan type, the pro limits (for the upgrade card) and which paid features are on.

Get SEO dashboard stats

POST /services/seo/v1/seo/dashboard/stats Auth

SEO Audit Schedules

List SEO audit schedules

POST /services/seo/v1/seo/schedules/list Auth

Create or update SEO audit schedule

POST /services/seo/v1/seo/schedules/upsert Auth

One schedule per (project, url). Upsert by URL inside the project.

Delete SEO audit schedule

POST /services/seo/v1/seo/schedules/delete Auth

SEO Competitors

List all competitors for the project with latest audit score

POST /services/seo/v1/seo/competitors/list Auth

Add a competitor to monitor and start an initial audit

POST /services/seo/v1/seo/competitors/store Auth

Competition overview

POST /services/seo/v1/seo/competitors/overview Auth

The own site next to every competitor in the plan: SEO score, PageSpeed (mobile, desktop, LCP, CLS, INP), measured response time and HTML size, broken links, their history, who wins per metric, and the three most valuable fixes (checks you fail that competitors pass).

Compare with competitors

POST /services/seo/v1/seo/competitors/compare Auth

Runs light scans (a few pages, PageSpeed once) of the own site and every competitor in the plan, or reuses scans younger than 24 hours. The scans count against the daily audit quota of the project.

Update competitor name or active status

POST /services/seo/v1/seo/competitors/{id}/update Auth

Remove a competitor

POST /services/seo/v1/seo/competitors/{id}/delete Auth

Re-scan a competitor URL

POST /services/seo/v1/seo/competitors/{id}/scan Auth

SearchConsole

POST /services/seo/v1/seo/search-console/status Auth
POST /services/seo/v1/seo/search-console/redirect Auth
POST /services/seo/v1/seo/search-console/setup Auth
POST /services/seo/v1/seo/search-console/verify Auth
POST /services/seo/v1/seo/search-console/sitemap Auth
POST /services/seo/v1/seo/search-console/refresh Auth

Forget the Google login here and revoke it at Google (the property stays in the owner's Search Console)

POST /services/seo/v1/seo/search-console/disconnect Auth