Global Pricing Recommendations — localize subscription prices

Global Pricing Recommendations API

What it does

Global Pricing Recommendations helps you generate country-specific subscription prices from a base price, base currency, and home country. Send the pricing inputs and get back a list of recommended prices for multiple markets.

Each recommendation includes a countryCode, countryName, recommendedPrice, and a justification explaining how the price was derived. The service also accepts billingFrequency (monthly, weekly, or annually) and an optional annualDiscountPercent for annual plans, so you can align recommendations with your billing model.

Use it when you need to localize SaaS pricing across regions without manually rebuilding a pricing table for every market. For example, you can generate localized price suggestions for launch planning, regional packaging, or market-entry analysis while keeping the response machine-readable for downstream workflows.

The output is structured for easy automation: loop through the returned recommendations array, present the suggested local price to your internal team, or feed it into pricing experiments and dashboards.

curl -X POST "https://api.eu.apyverse.com/namastesumalya/generate-global-pricing-recommendations" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "basePrice": 29.99, "baseCurrency": "USD", "homeCountry": "USA" }'

{ "recommendations": [ { "countryCode": "IN", "countryName": "India", "justification": "Adjusted from your base price using Purchasing Power Parity (PPP), local wage data, and currency conversion for a monthly billing cycle.", "recommendedPrice": "₹499" } ] }

About this endpoint

What it does

Generates global pricing recommendations from a base subscription price, base currency, and home country. The response returns a list of country-specific pricing recommendations with the country code, country name, justification, and formatted recommended price.

Request Body

Parameter	Type	Mandatory	Description
basePrice	Number	Yes	Base subscription price in the home market.
homeCountry	String	Yes	ISO 3166-1 alpha-2 two-letter country code representing the home market (e.g., US, IN, GB).
baseCurrency	String	Yes	ISO 4217 currency code for the base price (e.g., USD, EUR, INR).
billingFrequency	ENUM	No	Billing cycle for the subscription. Allowed values: `monthly`, `weekly`, `annually`. Default: `monthly`.
annualDiscountPercent	Number	No	Discount percentage applied for annual billing plans. Must be between 0 and 100.

Response

Returns a JSON object with a recommendations array field. Each item in the array is an object containing countryCode, countryName, justification, and recommendedPrice.

Parameter	Type	Mandatory	Description
recommendations	Object Array	No	List of pricing recommendations, one per country.
recommendations[].countryCode	String	No	ISO 3166-1 alpha-2 two-letter country code.
recommendations[].countryName	String	No	Full name of the country.
recommendations[].justification	String	No	Explanation of how the recommended price was derived for this market.
recommendations[].recommendedPrice	String	No	Recommended price formatted with the local currency symbol and amount.

Body

Name

Type

Description

bodyREQUIRED

object

Request body for generating global pricing recommendations.

Global Pricing Recommendations API

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return