That Marketing Buddy
Home/API/Temso
Temso

Temso API

Yes. Temso publishes a public REST API.

MCP also available
Public REST API documentedAgent-readiness 7/10
Data from Buddy's database, auto-rechecked weekly

What is the Temso API?

Temso ships a genuine public REST API, documented with a live OpenAPI 3.1.1 specification at https://api.temso.ai/v1/openapi.json (docs at docs.temso.ai). The endpoints cover the data a GEO agent actually wants: projects, raw AI responses, accepted brands, brand mentions, source citations, and analytics for visibility, share of voice and brand rankings, plus a POST traffic-ingestion endpoint for piping your own request events in.

The significant caveat is commercial, not technical. API access is labelled Custom API access and only appears on the $499 Professional tier, so Basic and Growth subscribers pay for tracking and the agent but cannot reach the data programmatically. For an agent build, that puts the real entry price at $499.

There are no documented SDKs, and the OpenAPI file does not declare a security scheme, though access is API-key based in practice. For agents, integration is straightforward REST against a well-structured, documented surface, once you are on the right plan.

For the broader picture: Temso review, full pricing breakdown, .

HOOK IT TO YOUR STACK

Real Temso API calls you'll write

temso-apirest
#Get the top organic keywords for a domain
GET/v3/site-explorer/organic-keywords?target=mysite.com&limit=10
200 OK · 10 results
marketing automationpos 4 · vol 12.4k
email marketing softwarepos 6 · vol 8.9k
seo tools 2026pos 8 · vol 6.3k
best crm small businesspos 12 · vol 4.6k
Cron daily to track ranking shifts.
temso-apirest
#Pull a competitor's backlink profile
GET/v3/site-explorer/backlinks?target=rival.com&limit=100
200 OK · 100 backlinks
Referring domains1,847
Domain Rating78
New backlinks (30d)+142
Lost backlinks (30d)-38
Pipe into a weekly Slack report.
temso-apirest
#Trigger a fresh site audit
POST/v3/site-audit/scan
202 Accepted · scan_id: 7f2a
Statusqueued
Estimated finish~4 min
Webhook callbackconfigured
Last scan issues47 (12 critical)
TMB SCORE FOR TemsoAgent fit: 7/10
Read review →

Endpoints illustrative. Confirm exact paths against the live API docs before integrating.

Pricing, limits, and integration

Temso's API is part of the SaaS subscription, not a standalone product, but it is tier-gated: Custom API access appears only on the $499/month Professional plan. Basic ($29) and Growth ($199) do not include it, so programmatic access starts at $499.

The API is documented with a live OpenAPI 3.1.1 spec (base https://api.temso.ai/v1) covering projects, AI responses, brands, mentions, sources and analytics (visibility, share of voice, brand rankings), plus POST /traffic/ingest/worker/{sourceId} for event ingestion. Auth is API-key based in practice; the spec does not declare a formal security scheme. No rate limits are published.

Operational limits are lightly documented: no published rate-limit threshold (a 429 error exists, so build in backoff), Bearer tms_ keys that are project-scoped, and required 90-day date filters on data endpoints. There are no SDKs or webhooks. Beyond the REST API, Temso runs a live OAuth MCP server (app.temso.ai/api/v1/mcp, read-only) for Claude, Cursor and ChatGPT, so agents have a no-key path as well as the programmatic one.

How much does the Temso API actually cost?

Verify on docs

Temso publishes an API, but per-tier gating wasn't extracted automatically.

  • Most likely scenario: API access is either included in all paid plans, or it's gated to higher tiers and we need to verify on the live docs page.
  • Until verified, treat the question "which plan unlocks the API" as open. Don't budget on the assumption it's free with the cheapest paid plan.

API at a glance

API docs
Auth method
SDK languages
OpenAPI spec
Webhooks
not available
Structured outputs

Which AI clients can read Temso data?

Not every AI assistant supports MCP natively. Here's the per-client picture for Temso specifically.

ClientSupportNotes
Claude CodeNative MCPAdd the Temso MCP connector (OAuth sign-in, no key). Read-only tools.
ChatGPTNative MCPConnect the Temso MCP server (OAuth). Read-only.
CursorNative MCPAdd the MCP connector (OAuth). Read-only tools.
Claude (Desktop/Web)Native MCPAdd as a custom connector via the MCP URL (OAuth).

Temso also has an MCP server

If you're wiring Temso into Claude / Cursor / Codex, the MCP server is usually less code than the REST API.

See Temso MCP page

What you can build with the Temso API

Three personas, three different shapes of build. Pick the row that matches how you actually ship.

SOLO DEV / FOUNDER

Glue Temso into your daily workflow

  • Pull a digest of ranking changes into your morning Slack
  • Trigger a one-off backfill when something looks off
  • Pipe data into your own SQLite for ad-hoc queries
Effort: A weekend, one Node or Python script
AGENCY / CONSULTANT

Sell Temso reporting at scale

  • White-label Temso data into client-branded dashboards
  • Run scheduled multi-account reports without logging into the Temso UI
  • Cross-reference with the rest of the client's stack (CRM, analytics, ad spend)
Effort: 1-2 weeks, hits multi-tenant auth quickly
IN-HOUSE ENGINEER

Production pipelines for Temso

  • Real-time sync into your warehouse on a cron
  • Custom alerts the dashboard's built-in alerting can't express
  • Backfill + idempotency handling for Temso data older than the dashboard exposes
Effort: Multi-week project, expect rate-limit tuning

Limits and gotchas

  • No OpenAPI spec — you write typed clients by hand or use a third-party generator on the docs HTML.
  • No official SDK detected. Plan on hitting the API directly with your HTTP client of choice.
  • Rate limits: always read the docs page before scaling — the published limit is usually lower than the practical one and overages can be expensive.
7/10

Agent-readiness verdict

A real, OpenAPI-documented REST API with the right endpoints for agent workflows, including a traffic-ingestion path. Held back only by the $499 access gate and the lack of SDKs. Solid 6 out of 10 for API agent-readiness.

Temso API FAQ

Should I use the API or the MCP server for Claude / Cursor / Codex?+
Prefer the MCP server for agent workflows — it's less code and pre-handles auth flows. Use the REST API for scheduled jobs, dashboards, and anything outside an LLM-driven flow.
Does Temso have a public API?+
Not documented publicly as of the last check. Some tools expose private/partner APIs — contact sales if you need programmatic access.

Sources

Joonas Rotko
Joonas RotkoAuthor & Founder of That Marketing Buddy

10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.

Temso

Try Temso