AskNicely API

Name: AskNicely API API
Brand: AskNicely API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsProduct AnalyticsapiKey1 EndpointsREST

For Agents

Retrieve NPS scores from AskNicely over a specified time window, with optional filtering by custom field.

Quickstart

Get started with AskNicely API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get an AskNicely NPS score for the last 30 days"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with AskNicely API API.

Pull NPS results for a specified number of past days from an AskNicely tenant

Filter NPS data by custom fields such as customer segment or product line

Surface raw promoter, passive, and detractor counts for downstream reporting

Drive a CX dashboard refresh with the latest NPS score

GET STARTED

Start building with AskNicely API API

Explore with Jentic

View OpenAPI Document

Use for: I need to get the NPS score for the last 30 days, Retrieve AskNicely NPS results filtered by customer segment, Find the current NPS score for our product, Check whether NPS has dropped in the last 7 days versus 30 days

Not supported: Does not handle survey design, response collection, or campaign sending — use for retrieving NPS score data only.

Jentic publishes the only available OpenAPI document for AskNicely API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for AskNicely API, keeping it validated and agent-ready. AskNicely is a customer experience platform focused on Net Promoter Score (NPS), CSAT, and CX feedback collection. The API exposes a single endpoint for retrieving NPS results over a configurable time window, with optional filtering by custom fields such as account or segment. Authentication uses an X-apikey header and the host subdomain is configurable per AskNicely tenant.

Use Cases

Patterns agents use AskNicely API API for, with concrete tasks.

★ Daily NPS Reporting

Automate the daily refresh of an internal NPS dashboard by calling GET /getnps/{days} at a fixed interval. Agents can compare today's 30-day score against last week's and post a Slack summary, removing the manual export step that CX teams typically run from the AskNicely UI.

Call GET /getnps/30 on the asknicely tenant, capture the score and response counts, and post a daily summary to a Slack channel

Segmented NPS Analysis

Use the optional custom-field filter on GET /getnps/{days} to break down NPS by customer segment, product line, or revenue band. Agents can build cohort-level NPS reports without exporting raw responses, supporting product and CS teams who need targeted views.

Call GET /getnps/90 filtered by the custom field 'plan=Enterprise' and return the segment NPS score

AI Agent for CX Reporting

An agent integrated through Jentic can fetch NPS scores on demand, summarise trends in plain language, and answer ad-hoc questions like 'how is our enterprise NPS this quarter?' — without holding the AskNicely API key. Jentic stores the X-apikey value in its vault and injects it at execution time.

Through Jentic, retrieve the 30-day NPS score for the Enterprise segment and produce a one-paragraph summary for the CX leader

Key Endpoints

1 endpoints — jentic publishes the only available openapi specification for asknicely api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/getnps/{days}

Get NPS score for the last N days

GET

/getnps/{days}

Get NPS score for the last N days

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

AskNicely API keys (X-apikey) are stored encrypted in the Jentic vault. Agents receive scoped execution access — the key is never exposed in prompts, logs, or agent memory and is injected as the X-apikey header at execution time.

Intent-based discovery

Agents search Jentic for 'get an NPS score' and Jentic returns the GET /getnps/{days} operation with its input schema, so the agent does not need to know the AskNicely tenant URL convention or the X-apikey header name in advance.

Time to first call

Direct AskNicely integration: a few hours to wire the X-apikey header and tenant subdomain. Through Jentic: under 10 minutes — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

SurveyMonkey

SurveyMonkey is a general-purpose survey platform; AskNicely is purpose-built for NPS and CX programmes.

Choose SurveyMonkey for ad-hoc surveys; pick AskNicely when running a continuous NPS or CSAT programme.

Alternative

Typeform

Typeform offers conversational surveys with strong UX customisation; AskNicely focuses on automated NPS workflows.

Choose Typeform when survey design and brand experience matter most; choose AskNicely for embedded NPS workflows.

Alternative

Survicate

Survicate runs in-product micro-surveys including NPS, complementing or replacing AskNicely depending on programme scope.

Use Survicate for in-product micro-surveys; pick AskNicely for email-driven NPS programmes with CX-team workflows.

FAQs

Specific to using AskNicely API API through Jentic.

Why is there no official OpenAPI spec for AskNicely API?

AskNicely does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call AskNicely API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the AskNicely API use?

The API uses an API key passed in the X-apikey header. The host is your AskNicely tenant subdomain (https://{subdomain}.asknice.ly/api/v1). Jentic stores the key in its vault and injects it at execution time so it never enters the agent's context.

Can I get an NPS score for the last N days?

Yes. GET /getnps/{days} returns the NPS score over the specified number of days. The path parameter sets the time window — for example /getnps/30 returns the rolling 30-day score.

Can I filter AskNicely NPS results by custom field?

Yes. The GET /getnps/{days} endpoint accepts optional query parameters that filter responses by custom fields configured in the AskNicely tenant — for example a customer segment, plan, or account identifier.

What are the rate limits for the AskNicely API?

The OpenAPI specification does not publish explicit rate limits. The endpoint is read-only, so cache the response if it is being used to refresh a dashboard at high frequency. Implement exponential backoff on HTTP 429 responses to stay within tenant quotas.

How do I retrieve NPS through Jentic?

Search Jentic for 'get an AskNicely NPS score' — the GET /getnps/{days} operation will be returned. Load the schema, supply the days value and any custom-field filters, and execute. Jentic handles the X-apikey header and tenant subdomain.