SmartNews

SmartNews is a news-discovery company whose consumer app ranks and delivers news to tens of millions of readers in Japan and the United States. For developers it operates the SmartNews Ads platform and publishes the SmartNews Marketing API (v3) — a REST API for programmatically managing advertising campaigns, ad groups, ads, media files, custom audiences, conversion pixels, and Business Manager product catalogs, plus an Insights API for performance reporting. The API uses OAuth 2.0 bearer (JWT) access tokens and is documented with a public OpenAPI 3.0 reference and an official API-spec repository.

SmartNews publishes 15 APIs on the APIs.io network, including ad API, ad-group API, article category API, and 12 more. Tagged areas include Company, Consumer, News, Advertising, and AdTech.

SmartNews’ developer surface includes authentication, documentation, API reference, getting-started guide, support, signup flow, changelog, and 21 more developer resources.

🌐 Visit website 📡 Source on GitHub
49.8/100 developing ▬ flat Agent 79/100 agent native Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
15 APIs 1 MCP Servers
CompanyConsumerNewsAdvertisingAdTechMarketingMediaCampaign Management

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 49.8/100 · developing
Contract Quality 15.2 / 25
Developer Ergonomics 13.0 / 20
Commercial Clarity 4.7 / 20
Operational Transparency 6.8 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 79/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 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 7 / 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/smartnews: 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 15

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

SmartNews ad API

The ad API from SmartNews — 3 operation(s) for ad.

SmartNews ad-group API

The ad-group API from SmartNews — 4 operation(s) for ad-group.

SmartNews article category API

The article category API from SmartNews — 1 operation(s) for article category.

SmartNews campaign API

The campaign API from SmartNews — 2 operation(s) for campaign.

SmartNews catalog API

The catalog API from SmartNews — 4 operation(s) for catalog.

SmartNews channel alias label API

The channel alias label API from SmartNews — 1 operation(s) for channel alias label.

SmartNews custom-audience API

The custom-audience API from SmartNews — 4 operation(s) for custom-audience.

SmartNews developer-app API

The developer-app API from SmartNews — 1 operation(s) for developer-app.

SmartNews insights API

The insights API from SmartNews — 2 operation(s) for insights.

SmartNews interests API

The interests API from SmartNews — 1 operation(s) for interests.

SmartNews locations API

The locations API from SmartNews — 1 operation(s) for locations.

SmartNews media-file API

The media-file API from SmartNews — 1 operation(s) for media-file.

SmartNews oauth API

The oauth API from SmartNews — 2 operation(s) for oauth.

SmartNews pixel API

The pixel API from SmartNews — 2 operation(s) for pixel.

SmartNews smart view article keyword API

The smart view article keyword API from SmartNews — 1 operation(s) for smart view article keyword.

Scroll for all 15

MCP Servers 1

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

smartnews-mcp.yml

MCP SERVER

Rate Limits 1

Documented rate limits and quota policies.

Smartnews Rate Limits

2 limits

RATE LIMITS

Security Posture 3

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

Smartnews Authentication

http · 1 scheme

SECURITY

Smartnews Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Smartnews Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Smartnews Agentic Access

46 operations · 21 acting · 1 human-in-the-loop

46 operations · 21 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference
 OpenAPI
OpenAPI

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

WellKnown
WellKnown
 AgenticAccess
AgenticAccess
 MCPServer
MCPServer
 LLMsTxt
LLMsTxt
 AgentSkill
AgentSkill

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Lifecycle
Lifecycle
 Conformance
Conformance
 DataModel
DataModel

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Packages
Packages

Access & Security 5

Authentication, authorization, and security posture

Security
Security
 SecurityTxt
SecurityTxt
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 3

Status, limits, changes, and where to get help

RateLimits
RateLimits
 Support
Support
 ChangeLog
ChangeLog

Commercial 1

Pricing, plans, and the legal terms of use

TermsOfService
TermsOfService

Company 1

The organization behind the API

Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: smartnews
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
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/smartnews.png
name: SmartNews
description: SmartNews is a news-discovery company whose consumer app ranks and delivers news to tens of millions of readers
  in Japan and the United States. For developers it operates the SmartNews Ads platform and publishes the SmartNews Marketing
  API (v3) — a REST API for programmatically managing advertising campaigns, ad groups, ads, media files, custom audiences,
  conversion pixels, and Business Manager product catalogs, plus an Insights API for performance reporting. The API uses OAuth
  2.0 bearer (JWT) access tokens and is documented with a public OpenAPI 3.0 reference and an official API-spec repository.
url: https://raw.githubusercontent.com/api-evangelist/smartnews/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- atomico
x-tier: enriched
x-tier-reason: has-public-api
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-21'
tags:
- Company
- Consumer
- News
- Advertising
- AdTech
- Marketing
- Media
- Campaign Management
apis:
- aid: smartnews:smartnews-ad-api
  name: SmartNews ad API
  description: The ad API from SmartNews — 3 operation(s) for ad.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - ad
  properties:
  - type: OpenAPI
    url: openapi/smartnews-ad-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-ad-group-api
  name: SmartNews ad-group API
  description: The ad-group API from SmartNews — 4 operation(s) for ad-group.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - ad-group
  properties:
  - type: OpenAPI
    url: openapi/smartnews-ad-group-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-article-category-api
  name: SmartNews article category API
  description: The article category API from SmartNews — 1 operation(s) for article category.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - article category
  properties:
  - type: OpenAPI
    url: openapi/smartnews-article-category-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-campaign-api
  name: SmartNews campaign API
  description: The campaign API from SmartNews — 2 operation(s) for campaign.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - campaign
  properties:
  - type: OpenAPI
    url: openapi/smartnews-campaign-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-catalog-api
  name: SmartNews catalog API
  description: The catalog API from SmartNews — 4 operation(s) for catalog.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - catalog
  properties:
  - type: OpenAPI
    url: openapi/smartnews-catalog-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-channel-alias-label-api
  name: SmartNews channel alias label API
  description: The channel alias label API from SmartNews — 1 operation(s) for channel alias label.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - channel alias label
  properties:
  - type: OpenAPI
    url: openapi/smartnews-channel-alias-label-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-custom-audience-api
  name: SmartNews custom-audience API
  description: The custom-audience API from SmartNews — 4 operation(s) for custom-audience.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - custom-audience
  properties:
  - type: OpenAPI
    url: openapi/smartnews-custom-audience-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-developer-app-api
  name: SmartNews developer-app API
  description: The developer-app API from SmartNews — 1 operation(s) for developer-app.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - developer-app
  properties:
  - type: OpenAPI
    url: openapi/smartnews-developer-app-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-insights-api
  name: SmartNews insights API
  description: The insights API from SmartNews — 2 operation(s) for insights.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - insights
  properties:
  - type: OpenAPI
    url: openapi/smartnews-insights-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-interests-api
  name: SmartNews interests API
  description: The interests API from SmartNews — 1 operation(s) for interests.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - interests
  properties:
  - type: OpenAPI
    url: openapi/smartnews-interests-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-locations-api
  name: SmartNews locations API
  description: The locations API from SmartNews — 1 operation(s) for locations.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - locations
  properties:
  - type: OpenAPI
    url: openapi/smartnews-locations-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-media-file-api
  name: SmartNews media-file API
  description: The media-file API from SmartNews — 1 operation(s) for media-file.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - media-file
  properties:
  - type: OpenAPI
    url: openapi/smartnews-media-file-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-oauth-api
  name: SmartNews oauth API
  description: The oauth API from SmartNews — 2 operation(s) for oauth.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - oauth
  properties:
  - type: OpenAPI
    url: openapi/smartnews-oauth-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-pixel-api
  name: SmartNews pixel API
  description: The pixel API from SmartNews — 2 operation(s) for pixel.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - pixel
  properties:
  - type: OpenAPI
    url: openapi/smartnews-pixel-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
- aid: smartnews:smartnews-smart-view-article-keyword-api
  name: SmartNews smart view article keyword API
  description: The smart view article keyword API from SmartNews — 1 operation(s) for smart view article keyword.
  humanURL: https://ads.smartnews.com/developers/
  baseURL: https://ads.smartnews.com
  tags:
  - smart view article keyword
  properties:
  - type: OpenAPI
    url: openapi/smartnews-smart-view-article-keyword-api-openapi.yml
  - type: Documentation
    url: https://ads.smartnews.com/developers/
  - type: APIReference
    url: https://ads.smartnews.com/developers/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: RateLimits
  url: rate-limits/smartnews-rate-limits.yml
- type: Security
  url: https://www.smartnews.com/.well-known/security.txt
- type: SecurityTxt
  url: well-known/smartnews-security.txt
- type: WellKnown
  url: well-known/smartnews-well-known.yml
- type: VulnerabilityDisclosure
  url: security/smartnews-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/smartnews-domain-security.yml
- type: AgenticAccess
  url: agentic-access/smartnews-agentic-access.yml
- type: Authentication
  url: authentication/smartnews-authentication.yml
- type: Website
  url: https://www.smartnews.com
- type: DeveloperPortal
  url: https://ads.smartnews.com/developers/
- type: Documentation
  url: https://ads.smartnews.com/developers/
- type: APIReference
  url: https://ads.smartnews.com/developers/
- type: GettingStarted
  url: https://help-ads.smartnews.com/en/item-4207/
- type: Support
  url: https://help-ads.smartnews.com/en/
- type: TermsOfService
  url: https://ads.smartnews.com/developers/tos-en.html
- type: GitHubOrganization
  url: https://github.com/smartnews
- type: SignUp
  url: https://ads.smartnews.com/
- type: OpenAPI
  url: openapi/smartnews-marketing-openapi.json
- type: Conventions
  url: conventions/smartnews-conventions.yml
- type: ErrorCatalog
  url: errors/smartnews-problem-types.yml
- type: Lifecycle
  url: lifecycle/smartnews-lifecycle.yml
- type: ChangeLog
  url: changelog/smartnews-changelog.yml
- type: Conformance
  url: conformance/smartnews-conformance.yml
- type: DataModel
  url: data-model/smartnews-data-model.yml
- type: MCPServer
  url: mcp/smartnews-mcp.yml
- type: Packages
  url: packages/smartnews-packages.yml
- type: LLMsTxt
  url: llms/smartnews-llms.txt
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: 2026-07-21
  status: enriched
  artifacts_added: 22
  pass: local-v1