AskNicely website screenshot

AskNicely

AskNicely is a customer-experience (CX) platform for service businesses, built around Net Promoter Score, CSAT and 5-Star surveys delivered by email, SMS, web badge and in-app. It collects frontline feedback, routes it to managers and staff through leaderboards, coaching and case management, and syndicates positive responses to review sites through its Reputation/Review Manager. Founded in Auckland, New Zealand in 2014, AskNicely serves franchise, home-services, healthcare, fitness and professional-services operators. Its public REST API (`https://{domain}.asknice.ly/api/v1`) covers contact import, survey triggering, response and statistics retrieval, unsubscribe lists and GDPR erasure, authenticated with a single `X-apikey` header, and it ships a per-tenant remote MCP server for its Ask NiceAI assistant.

AskNicely publishes 5 APIs on the APIs.io network, including Contacts API, In-App Surveys API, Responses API, and 2 more. Tagged areas include Company, Customer Experience, Net Promoter Score, Surveys, and Feedback.

The AskNicely catalog on APIs.io includes 1 event-driven AsyncAPI specification.

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

🌐 Visit website 📡 Source on GitHub
63.1/100 strong ▬ flat Agent 52/100 agent ready Full breakdown ↓
scored 2026-08-12 · rubric v0.11.0
6 APIs 1 MCP Servers
CompanyCustomer ExperienceNet Promoter ScoreSurveysFeedbackReputation ManagementSaaSCustomer SuccessReviewsSMS

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-12 · rubric v0.11.0
Composite quality — 63.1/100 · strong
Contract Quality 15.5 / 21
Developer Ergonomics 9.1 / 17
Commercial Clarity 10.3 / 17
Operational Transparency 9.3 / 11
Governance 1.2 / 10
Discoverability 7.9 / 9
Regulatory Posture 9.8 / 15
Agent readiness — 52/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 0 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Telecommunications regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
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/asknicely: 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 6

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

AskNicely MCP Server (Ask NiceAI)

AskNicely's remote Model Context Protocol server, exposing Ask NiceAI's tools — NPS summaries, survey responses, leaderboards and more — to external AI clients such as Claude. S...

AskNicely Contacts API

Import, look up, deactivate and privacy-delete contacts.

AskNicely In-App Surveys API

Server-to-server negotiation of an in-app survey slug.

AskNicely Responses API

Retrieve survey responses.

AskNicely Statistics API

NPS, sent and historical survey statistics.

AskNicely Surveys API

Trigger NPS/CSAT/5-Star surveys to contacts.

MCP Servers 1

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

asknicely-mcp.yml

MCP SERVER

Rate Limits 1

Documented rate limits and quota policies.

Asknicely Rate Limits

4 limits

RATE LIMITS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Asknicely Webhooks

ASYNCAPI

Security Posture 3

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

Asknicely Authentication

apiKey · 1 scheme

SECURITY

Asknicely Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Asknicely Trust Center

SOC 2, ISO 27001, PCI DSS, GDPR, CSA STAR (CAIQ), New Zealand Privacy Act

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Asknicely Scopes

1 scope · authorizationCode

1 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 3

MCP servers, agent skills, and machine-readable catalogs

WellKnown
WellKnown
 AgentSkill
AgentSkill
 LLMsTxt
LLMsTxt

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Lifecycle
Lifecycle
 Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 Conformance
Conformance
 DataModel
DataModel
 Webhooks
Webhooks
 Components
Components

Scroll for all 7

Build 2

SDKs, sample code, and the tooling you integrate with

GitHubOrganization
GitHubOrganization
 Packages
Packages

Access & Security 5

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 Compliance
Compliance
 Authentication
Authentication
 OAuthScopes
OAuthScopes
 DomainSecurity
DomainSecurity

Operate 5

Status, limits, changes, and where to get help

Support
Support
 StatusPage
StatusPage
 ChangeLog
ChangeLog
 Deprecation
Deprecation
 RateLimits
RateLimits

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

Other 1

Properties that don't map to a standard resource type

Overlay
Overlay

Source (apis.yml)

apis.yml Raw ↑ 
aid: asknicely
name: AskNicely
description: AskNicely is a customer-experience (CX) platform for service businesses, built around Net Promoter Score, CSAT
  and 5-Star surveys delivered by email, SMS, web badge and in-app. It collects frontline feedback, routes it to managers
  and staff through leaderboards, coaching and case management, and syndicates positive responses to review sites through
  its Reputation/Review Manager. Founded in Auckland, New Zealand in 2014, AskNicely serves franchise, home-services, healthcare,
  fitness and professional-services operators. Its public REST API (`https://{domain}.asknice.ly/api/v1`) covers contact import,
  survey triggering, response and statistics retrieval, unsubscribe lists and GDPR erasure, authenticated with a single `X-apikey`
  header, and it ships a per-tenant remote MCP server for its Ask NiceAI assistant.
image: https://cdn.prod.website-files.com/5e55a51f5f18f823ee05f445/5ec34b022aca806dce613ba4_AN_logo_white.png
url: https://raw.githubusercontent.com/api-evangelist/asknicely/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-06'
modified: '2026-08-06'
tags:
- Company
- Customer Experience
- Net Promoter Score
- Surveys
- Feedback
- Reputation Management
- SaaS
- Customer Success
- Reviews
- SMS
x-enrichment:
  date: '2026-08-06'
  status: enriched
  artifacts_added: 30
  pass: local-v1
x-coverage:
  state: covered
  reason: full-pass
  detail: AskNicely's complete public API reference is served from any tenant host at /help/apidocs (17 pages, including a
    dated API changelog), and it operates a first-party remote MCP server whose OAuth 2.1 metadata is anonymously readable
    — both were captured. AskNicely publishes no OpenAPI of its own, so the spec in openapi/ was transcribed from those pages;
    the MCP tools/list is OAuth-gated.
  evidence:
  - url: https://demo.asknice.ly/help/apidocs
    status: 200
  - url: https://mcp.asknice.ly/.well-known/oauth-authorization-server
    status: 200
  - url: https://nicely.asknice.ly/mcp
    status: 401
  checked: '2026-08-06'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- name: AskNicely MCP Server (Ask NiceAI)
  description: AskNicely's remote Model Context Protocol server, exposing Ask NiceAI's tools — NPS summaries, survey responses,
    leaderboards and more — to external AI clients such as Claude. Served per tenant at https://{domain}.asknice.ly/mcp, protected
    by OAuth 2.1 (dynamic client registration, PKCE S256, scope `tools`) with the authorization server at https://mcp.asknice.ly.
    Requires the Ask NiceAI add-on on the AskNicely account.
  humanURL: https://asknicely.zendesk.com/hc/en-us/articles/51310930486292-Adding-AskNicely-as-a-Custom-Connector-in-Claude
  baseURL: https://nicely.asknice.ly/mcp
  tags:
  - MCP
  - AI
  - Agents
  properties:
  - type: MCPServer
    url: mcp/asknicely-mcp.yml
  - type: ToolCrosswalk
    url: mcp/asknicely-tool-crosswalk.yml
  - type: Documentation
    url: https://asknicely.zendesk.com/hc/en-us/articles/46840078787988-Ask-NiceAI
- aid: asknicely:asknicely-contacts-api
  name: AskNicely Contacts API
  description: Import, look up, deactivate and privacy-delete contacts.
  humanURL: https://demo.asknice.ly/help/apidocs
  baseURL: https://demo.asknice.ly/api/v1
  tags:
  - Contacts
  properties:
  - type: OpenAPI
    url: openapi/asknicely-contacts-api-openapi.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs
  - type: APIReference
    url: https://demo.asknice.ly/help/apidocs
  - type: GettingStarted
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: Authentication
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: ChangeLog
    url: https://demo.asknice.ly/help/apidocs/changelog
  - type: RateLimits
    url: rate-limits/asknicely-rate-limits.yml
  - type: Examples
    url: examples/asknicely-examples.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs/inapp
  - type: SourceCode
    url: https://github.com/asknicely/asknicely-mobile-inapp-samples
- aid: asknicely:asknicely-in-app-surveys-api
  name: AskNicely In-App Surveys API
  description: Server-to-server negotiation of an in-app survey slug.
  humanURL: https://demo.asknice.ly/help/apidocs
  baseURL: https://demo.asknice.ly/api/v1
  tags:
  - In-App Surveys
  properties:
  - type: OpenAPI
    url: openapi/asknicely-in-app-surveys-api-openapi.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs
  - type: APIReference
    url: https://demo.asknice.ly/help/apidocs
  - type: GettingStarted
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: Authentication
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: ChangeLog
    url: https://demo.asknice.ly/help/apidocs/changelog
  - type: RateLimits
    url: rate-limits/asknicely-rate-limits.yml
  - type: Examples
    url: examples/asknicely-examples.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs/inapp
  - type: SourceCode
    url: https://github.com/asknicely/asknicely-mobile-inapp-samples
- aid: asknicely:asknicely-responses-api
  name: AskNicely Responses API
  description: Retrieve survey responses.
  humanURL: https://demo.asknice.ly/help/apidocs
  baseURL: https://demo.asknice.ly/api/v1
  tags:
  - Responses
  properties:
  - type: OpenAPI
    url: openapi/asknicely-responses-api-openapi.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs
  - type: APIReference
    url: https://demo.asknice.ly/help/apidocs
  - type: GettingStarted
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: Authentication
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: ChangeLog
    url: https://demo.asknice.ly/help/apidocs/changelog
  - type: RateLimits
    url: rate-limits/asknicely-rate-limits.yml
  - type: Examples
    url: examples/asknicely-examples.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs/inapp
  - type: SourceCode
    url: https://github.com/asknicely/asknicely-mobile-inapp-samples
- aid: asknicely:asknicely-statistics-api
  name: AskNicely Statistics API
  description: NPS, sent and historical survey statistics.
  humanURL: https://demo.asknice.ly/help/apidocs
  baseURL: https://demo.asknice.ly/api/v1
  tags:
  - Statistics
  properties:
  - type: OpenAPI
    url: openapi/asknicely-statistics-api-openapi.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs
  - type: APIReference
    url: https://demo.asknice.ly/help/apidocs
  - type: GettingStarted
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: Authentication
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: ChangeLog
    url: https://demo.asknice.ly/help/apidocs/changelog
  - type: RateLimits
    url: rate-limits/asknicely-rate-limits.yml
  - type: Examples
    url: examples/asknicely-examples.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs/inapp
  - type: SourceCode
    url: https://github.com/asknicely/asknicely-mobile-inapp-samples
- aid: asknicely:asknicely-surveys-api
  name: AskNicely Surveys API
  description: Trigger NPS/CSAT/5-Star surveys to contacts.
  humanURL: https://demo.asknice.ly/help/apidocs
  baseURL: https://demo.asknice.ly/api/v1
  tags:
  - Surveys
  properties:
  - type: OpenAPI
    url: openapi/asknicely-surveys-api-openapi.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs
  - type: APIReference
    url: https://demo.asknice.ly/help/apidocs
  - type: GettingStarted
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: Authentication
    url: https://demo.asknice.ly/help/apidocs/auth
  - type: ChangeLog
    url: https://demo.asknice.ly/help/apidocs/changelog
  - type: RateLimits
    url: rate-limits/asknicely-rate-limits.yml
  - type: Examples
    url: examples/asknicely-examples.yml
  - type: Documentation
    url: https://demo.asknice.ly/help/apidocs/inapp
  - type: SourceCode
    url: https://github.com/asknicely/asknicely-mobile-inapp-samples
common:
- type: Overlay
  url: overlays/asknicely-openapi-overlay.yaml
- type: TrustCenter
  url: security/asknicely-trust-center.yml
- type: Website
  url: https://www.asknicely.com/
- type: DeveloperPortal
  url: https://demo.asknice.ly/help/apidocs
- type: Documentation
  url: https://demo.asknice.ly/help/apidocs
- type: APIReference
  url: https://demo.asknice.ly/help/apidocs
- type: GettingStarted
  url: https://demo.asknice.ly/help/apidocs/auth
- type: Support
  url: https://asknicely.zendesk.com/hc/en-us
- type: Blog
  url: https://www.asknicely.com/resource-hub
- type: GitHubOrganization
  url: https://github.com/asknicely
- type: Pricing
  url: https://www.asknicely.com/pricing
- type: SignUp
  url: https://start.asknice.ly/findlogin/
- type: TermsOfService
  url: https://www.asknicely.com/terms
- type: PrivacyPolicy
  url: https://www.asknicely.com/privacy
- type: Compliance
  url: https://www.asknicely.com/security
- type: StatusPage
  url: https://status.asknicely.com/
- type: Integrations
  url: https://www.asknicely.com/integrations
- type: ChangeLog
  url: changelog/asknicely-changelog.yml
- type: Lifecycle
  url: lifecycle/asknicely-lifecycle.yml
- type: Deprecation
  url: https://demo.asknice.ly/help/apidocs/changelog
- type: Authentication
  url: authentication/asknicely-authentication.yml
- type: OAuthScopes
  url: scopes/asknicely-scopes.yml
- type: Conventions
  url: conventions/asknicely-conventions.yml
- type: ErrorCatalog
  url: errors/asknicely-problem-types.yml
- type: RateLimits
  url: rate-limits/asknicely-rate-limits.yml
- type: Conformance
  url: conformance/asknicely-conformance.yml
- type: WellKnown
  url: well-known/asknicely-well-known.yml
- type: DomainSecurity
  url: security/asknicely-domain-security.yml
- type: DataModel
  url: data-model/asknicely-data-model.yml
- type: Webhooks
  url: asyncapi/asknicely-webhooks.yml
- type: Packages
  url: packages/asknicely-packages.yml
- type: Components
  url: components/asknicely-components.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/asknicely-llms.txt