Skip to main content
Login

The Jobs API

Your Stack.
Our Research Team.

Trigger Jobs from n8n, Make, Zapier, or your own stack. White-label PDFs, slides, and JSON via webhook. ~15 minutes.

Included with every plan. PAYG and members.

POST /v1/reports/signal

{
  "url": "https://yoursite.com",
  "personas": ["cmo", "founder"],
  "webhook": "https://you.com/hook"
}

One API. Three Job Types.

AI Visibility

How AI talks about your brand across seven platforms. Persona-aware. Competitive. The full picture.

POST /v1/reports/signal

Site Audit

Speed, SEO, security, accessibility, and schema. 30 or 100 pages deep. Technical receipts, not guesses.

POST /v1/reports/scan

Strategy

Recommendations pressure-tested across seven AI platforms. Chain from AI Visibility or Site Audit via Intelligence Token.

POST /v1/reports/solutions

Deterministic crawlers. Seven-engine scoring. ML classification. Job-scoped context. White-label out the other side.

Agencies

You're the fractional team for your clients. Surmado is the fractional team for you. White-label results by webhook, no dashboard required. Portfolio: unlimited brands, 20 Jobs/month.

Developers

Build on Scout. Pull structured data from any Job, integrate with Zapier, Make, n8n, or your own stack. RESTful, Bearer token auth, test mode included. Python and Node.js examples in the docs.

API FAQ

How is this different from Claude Skills or LLM connectors?

Skills give your team a generalist to prompt. Surmado is an opinionated pipeline with deterministic crawlers, seven-engine scoring, Job-scoped context, and white-label output. Callable, not maintained.

What's actually under the API?

Deterministic site crawlers, seven-engine AI visibility with normalized scoring, ML classification, and Job-scoped context per brand. Not a thin LLM wrapper.

Can I white-label the output?

Yes. PDFs and slides ship brand-ready. Structured JSON is yours to route, transform, or render however you want.

Does it work with n8n, Make, or Zapier?

Native integration guides for all three. Webhooks are HMAC-signed. REST is standard Bearer auth.

Can I chain Jobs?

Yes. Completed AI Visibility and Site Audit reports return an Intelligence Token. Pass it into Strategy to reason over real data, not a fresh prompt.

What happens when a Job fails?

Credits are auto-refunded. Webhook fires with report.failed and a reason.

API Access. Every Plan. No Add-On.

Included with every plan. Trigger Jobs, get results, build integrations.

VIEW DOCS

Questions? hi@surmado.com