Supermetrics

Supermetrics is a marketing intelligence platform that automates the pipeline of marketing and advertising data from 100+ sources (Google Ads, Facebook/Meta Ads, TikTok, Google Analytics, LinkedIn Ads, and more) into spreadsheets, BI tools, and data warehouses. Its public Product API (v2) lets developers query that data programmatically over REST, run long-running extracts asynchronously, and manage teams, saved queries, data-source logins, and Data Warehouse backfills via a Management API. Authentication is by API key (Bearer) or a full OAuth2/OIDC flow, and Supermetrics also ships an official Python SDK, a Go CLI, an n8n node, and a hosted MCP server for connecting AI assistants to live marketing data.

Supermetrics publishes 1 API on the APIs.io network. Tagged areas include Company, Marketing, Analytics, Advertising, and Data.

Supermetrics’ developer surface includes documentation, API reference, getting-started guide, support, engineering blog, pricing, signup flow, and 28 more developer resources.

🌐 Visit website 📡 Source on GitHub
44.6/100 thin ▬ flat Agent 40/100 agent aware Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
1 APIs 1 MCP Servers
CompanyMarketingAnalyticsAdvertisingDataReportingBusiness IntelligenceData Warehouse

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 44.6/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 16.1 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 7.2 / 13
Governance 0.0 / 12
Discoverability 9.3 / 10
Agent readiness — 40/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 3 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/supermetrics: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

Supermetrics API

REST Product API (v2) to query marketing data from connected data sources, with synchronous and asynchronous query execution, plus a Management API for API keys, saved queries, ...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

supermetrics-mcp.yml

MCP SERVER

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Supermetrics Authentication

http/oauth2/openIdConnect · 4 schemes

SECURITY

Supermetrics Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Supermetrics Vulnerability Disclosure

security.txt · contact published

SECURITY

Supermetrics Trust Center

SOC 2, ISO 27001, GDPR

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Supermetrics Scopes

13 scopes · authorizationCode

13 scopes

SCOPES

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

MCPServer
MCPServer
 AgentSkill
AgentSkill
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Lifecycle
Lifecycle
 ErrorCatalog
ErrorCatalog
 Conventions
Conventions
 Components
Components
 Conformance
Conformance

Build 4

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Packages
Packages
 SDKs
SDKs
 CLI
CLI

Access & Security 8

Authentication, authorization, and security posture

Authentication
Authentication
 OAuthScopes
OAuthScopes
 SecurityTxt
SecurityTxt
 Compliance
Compliance
 TrustCenter
TrustCenter
 DomainSecurity
DomainSecurity
 VulnerabilityDisclosure
VulnerabilityDisclosure
 Security
Security

Scroll for all 8

Operate 4

Status, limits, changes, and where to get help

Support
Support
 StatusPage
StatusPage
 ChangeLog
ChangeLog
 Deprecation
Deprecation

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 TermsOfService
TermsOfService
 PrivacyPolicy
PrivacyPolicy

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: supermetrics
name: Supermetrics
description: Supermetrics is a marketing intelligence platform that automates the pipeline of marketing and advertising data
  from 100+ sources (Google Ads, Facebook/Meta Ads, TikTok, Google Analytics, LinkedIn Ads, and more) into spreadsheets, BI
  tools, and data warehouses. Its public Product API (v2) lets developers query that data programmatically over REST, run
  long-running extracts asynchronously, and manage teams, saved queries, data-source logins, and Data Warehouse backfills
  via a Management API. Authentication is by API key (Bearer) or a full OAuth2/OIDC flow, and Supermetrics also ships an official
  Python SDK, a Go CLI, an n8n node, and a hosted MCP server for connecting AI assistants to live marketing data.
url: https://raw.githubusercontent.com/api-evangelist/supermetrics/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- ivp
x-tier: stub
x-tier-reason: portfolio-lead
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-21'
image: https://supermetrics.com/favicon.ico
tags:
- Company
- Marketing
- Analytics
- Advertising
- Data
- Reporting
- Business Intelligence
- Data Warehouse
apis:
- name: Supermetrics API
  description: REST Product API (v2) to query marketing data from connected data sources, with synchronous and asynchronous
    query execution, plus a Management API for API keys, saved queries, teams, data-source logins/login-links, and Data Warehouse
    backfills.
  humanURL: https://docs.supermetrics.com/apidocs
  baseURL: https://api.supermetrics.com/enterprise/v2
  properties:
  - type: Documentation
    url: https://docs.supermetrics.com/apidocs
  - type: APIReference
    url: https://docs.supermetrics.com/apidocs/making-requests
  - type: GettingStarted
    url: https://docs.supermetrics.com/apidocs/getting-started
  - type: Authentication
    url: authentication/supermetrics-authentication.yml
  - type: OAuthScopes
    url: scopes/supermetrics-scopes.yml
  - type: ErrorCatalog
    url: errors/supermetrics-problem-types.yml
  - type: Conventions
    url: conventions/supermetrics-conventions.yml
  - type: RateLimits
    url: https://docs.supermetrics.com/apidocs/usage-limits
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://supermetrics.com
- type: DeveloperPortal
  url: https://supermetrics.com/products/api
- type: Documentation
  url: https://docs.supermetrics.com/
- type: APIReference
  url: https://docs.supermetrics.com/apidocs
- type: GettingStarted
  url: https://docs.supermetrics.com/apidocs/getting-started
- type: Support
  url: https://docs.supermetrics.com/docs/about-supermetrics-support.md
- type: Blog
  url: https://supermetrics.com/blog
- type: GitHubOrganization
  url: https://github.com/supermetrics-public
- type: Pricing
  url: https://supermetrics.com/pricing
- type: SignUp
  url: https://supermetrics.com/start-trial
- type: TermsOfService
  url: https://supermetrics.com/terms-of-service
- type: PrivacyPolicy
  url: https://supermetrics.com/privacy-policy
- type: StatusPage
  url: https://status.supermetrics.com
- type: ChangeLog
  url: changelog/supermetrics-changelog.yml
- type: Lifecycle
  url: lifecycle/supermetrics-lifecycle.yml
- type: Deprecation
  url: https://docs.supermetrics.com/docs/system-updates.md
- type: Authentication
  url: authentication/supermetrics-authentication.yml
- type: OAuthScopes
  url: scopes/supermetrics-scopes.yml
- type: ErrorCatalog
  url: errors/supermetrics-problem-types.yml
- type: Conventions
  url: conventions/supermetrics-conventions.yml
- type: Packages
  url: packages/supermetrics-packages.yml
- type: SDKs
  url: packages/supermetrics-packages.yml
- type: CLI
  url: cli/supermetrics-cli.yml
- type: Components
  url: components/supermetrics-components.yml
- type: MCPServer
  url: mcp/supermetrics-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/supermetrics-llms.txt
- type: WellKnown
  url: well-known/supermetrics-well-known.yml
- type: SecurityTxt
  url: well-known/supermetrics-security.txt
- type: Conformance
  url: conformance/supermetrics-conformance.yml
- type: Compliance
  url: https://trust.supermetrics.com/
- type: TrustCenter
  url: security/supermetrics-trust-center.yml
- type: DomainSecurity
  url: security/supermetrics-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/supermetrics-vulnerability-disclosure.yml
- type: Security
  url: https://supermetrics.com/.well-known/security.txt
x-enrichment:
  date: '2026-07-21'
  status: enriched
  artifacts_added: 21
  pass: local-v1