Pricing API - PricingSaaS Intelligence API

Overview

The Pricing API provides access to detailed, structured pricing data for B2B SaaS companies. Get comprehensive pricing plans, charges, discounts, and metrics for any company in our database.

All pricing endpoints require authentication and cost 1 credit per request.

Get Pricing Structure

Retrieve complete pricing information for a company’s pricing page, including all plans, charges, and discounts.

slug

string

required

Company slug or company.page format

Use notion for companies with a single pricing page
Use atlassian.jira for companies with multiple pricing pages

version

string

Specific version in YYYYMMDD format (e.g., 20251010)If not provided, returns the latest version

period

string

Period in any supported format:

Quarter: 2025Q4
Week: 2025W42
Month: 2025M12 or 202512

Returns the earliest version within the specified period

Latest Version (Default)

Get the most recent pricing data for a company:

curl "https://api.pricingsaas.com/functions/v1/api/pricing/notion" \
  -H "X-API-Key: YOUR_API_KEY"

Specific Version

Get pricing data for a specific date:

curl "https://api.pricingsaas.com/functions/v1/api/pricing/notion?version=20251010" \
  -H "X-API-Key: YOUR_API_KEY"

Period Query

Get pricing data from a specific time period:

# Get Q4 2025 pricing
curl "https://api.pricingsaas.com/functions/v1/api/pricing/notion?period=2025Q4" \
  -H "X-API-Key: YOUR_API_KEY"

# Get Week 42 of 2025
curl "https://api.pricingsaas.com/functions/v1/api/pricing/notion?period=2025W42" \
  -H "X-API-Key: YOUR_API_KEY"

Multiple Pages

For companies with multiple pricing pages, use dot notation:

curl "https://api.pricingsaas.com/functions/v1/api/pricing/atlassian.jira" \
  -H "X-API-Key: YOUR_API_KEY"

Response Structure

{
  "slug": "notion",
  "company_slug": "notion",
  "page_subslug": "",
  "page_id": "e724654e-aa7a-4db8-8eeb-d89e0ae21baa",
  "version": "20251010",
  "scrape": {
    "id": "02c4b74e-598d-41d8-b604-1ead36e102be",
    "version": "20251010",
    "page_url": "https://www.notion.so/pricing",
    "created_at": "2025-10-10T12:00:00Z"
  },
  "plans": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "display_name": "Plus",
      "internal_name": "plus",
      "add_on": false,
      "charges": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440001",
          "billing": "monthly_recurring_billed_monthly",
          "currency": "USD",
          "price": 10.00,
          "charge_type": "metered",
          "pricing_metric": {
            "id": "b47269ed-a4da-4873-be66-e0297db7496d",
            "display_name": "per user",
            "modality": "user_based"
          },
          "usage_type": "licensed",
          "display_name": "Plus Plan",
          "price_display": "$10/user/month",
          "included_quantity": null,
          "overage_info": null
        }
      ],
      "discounts": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440002",
          "discount_category": "annual_discount",
          "amount_type": "percent",
          "amount": 20,
          "description": "Save up to 20% with yearly billing",
          "duration": "12 months"
        }
      ]
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440003",
      "display_name": "Business",
      "internal_name": "business",
      "add_on": false,
      "charges": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440004",
          "billing": "monthly_recurring_billed_monthly",
          "currency": "USD",
          "price": 20.00,
          "charge_type": "metered",
          "pricing_metric": {
            "id": "b47269ed-a4da-4873-be66-e0297db7496d",
            "display_name": "per user",
            "modality": "user_based"
          },
          "usage_type": "licensed",
          "display_name": "Business Plan",
          "price_display": "$20/user/month"
        }
      ],
      "discounts": []
    }
  ]
}

Response Fields

slug

string

Full slug identifier (e.g., “notion” or “atlassian.jira”)

company_slug

string

Company identifier

page_subslug

string

Page identifier (empty string for primary pricing page)

page_id

string

UUID of the pricing page

version

string

Version in YYYYMMDD format

scrape

object

Metadata about the pricing page scrape

Show Scrape Object

string

UUID of the scrape

version

string

Version identifier (YYYYMMDD)

page_url

string

URL of the scraped pricing page

created_at

string

Timestamp when the scrape was created

plans

array

Array of pricing plans

Show Plan Object

string

UUID of the plan

display_name

string

Public-facing name (e.g., “Professional”, “Enterprise”)

internal_name

string

Internal identifier (e.g., “pro”, “enterprise”)

add_on

boolean

Whether this is an add-on product

charges

array

Array of charges for this plan

Show Charge Object

billing

string

Billing type (e.g., “monthly_recurring_billed_monthly”, “freemium”)

currency

string

Currency code (e.g., “USD”, “EUR”)

price

number

Price amount (null for freemium or contact sales)

charge_type

string

Type of charge: flat or metered

pricing_metric

object

Metric for metered charges (null for flat charges)

Show Pricing Metric Object

display_name

string

Human-readable metric name

modality

string

Metric modality (e.g., “user_based”, “usage_based”)

usage_type

string

How usage is measured: licensed, metered, pay_as_you_go

display_name

string

Display name for the charge

price_display

string

Formatted price string (e.g., “$10/user/month”)

discounts

array

Array of discounts available for this plan

Show Discount Object

discount_category

string

Category of discount (e.g., “annual_discount”, “education_discount”)

amount_type

string

Type of discount: percent, fixed_amount, free

amount

number

Discount amount (percentage or fixed value)

description

string

Human-readable description

duration

string

How long the discount applies

Error Responses

Company Not Found

{
  "error": "Company not found",
  "code": "NOT_FOUND",
  "details": {
    "slug": "invalid-company",
    "message": "No company found with slug 'invalid-company'"
  }
}

Page Not Found

{
  "error": "Page not found",
  "code": "NOT_FOUND",
  "details": {
    "slug": "notion.enterprise",
    "message": "No page found with slug 'notion.enterprise'"
  }
}

Version Not Found

When requesting a specific version that doesn’t exist, you’ll receive helpful alternatives:

{
  "error": "Version not found",
  "code": "VERSION_NOT_FOUND",
  "details": {
    "slug": "notion",
    "requested_version": "20240101",
    "message": "No data found for version '20240101'",
    "available_versions": [
      "20251010",
      "20251001",
      "20250901"
    ],
    "latest_version": "20251010",
    "suggestion": "Try version '20251010' (latest)"
  }
}

Period Not Found

{
  "error": "No data found for period",
  "code": "PERIOD_NOT_FOUND",
  "details": {
    "slug": "notion",
    "requested_period": "2024Q1",
    "message": "No scrapes found in period '2024Q1'",
    "latest_version": "20251010",
    "suggestion": "Try the latest version '20251010'"
  }
}

Pricing Models

Our API supports all common B2B SaaS pricing models:

Per-User (Seat-Based)

Price scales with number of usersExample Companies: Slack, Figma, Notion

{
  "charge_type": "metered",
  "pricing_metric": {
    "display_name": "per user",
    "modality": "user_based"
  },
  "price": 10,
  "price_display": "$10/user/month"
}

Usage-Based

Pay for what you useExample Companies: Stripe, Twilio, AWS

{
  "charge_type": "metered",
  "pricing_metric": {
    "display_name": "per API call",
    "modality": "usage_based"
  },
  "usage_type": "pay_as_you_go",
  "price": 0.01
}

Flat Rate

Single price for unlimited accessExample Companies: Basecamp

{
  "charge_type": "flat",
  "pricing_metric": null,
  "price": 99,
  "price_display": "$99/month"
}

Freemium

Free tier with paid upgradesExample Companies: Notion, Airtable

{
  "billing": "freemium",
  "charge_type": "flat",
  "price": null
}

Billing Types

billing

string

How and when customers are charged:

monthly_recurring_billed_monthly - Monthly subscription, billed monthly
monthly_recurring_billed_yearly - Monthly rate, billed annually
annual_recurring_billed_yearly - Annual subscription
one_time - Single payment
freemium - Free tier
pricing_not_disclosed - Contact sales / custom pricing

Discount Categories

Common discount types you’ll find in the API:

Annual Discount

Savings for annual vs monthly billing

Volume Discount

Discounts for larger teams

Education Discount

Special pricing for educational institutions

Nonprofit Discount

Reduced rates for nonprofits

Startup Discount

Deals for early-stage companies

Promotional

Limited-time promotional offers

Use Cases

Competitive Analysis

Compare pricing across competitors in your market

Pricing Research

Research pricing strategies and trends

Market Intelligence

Understand market pricing dynamics

Pricing Strategy

Inform your pricing decisions with data

Rate Limiting

Each pricing API call costs 1 credit. Credits are tracked per API key and reset based on your billing cycle.

Need more credits? Contact us at [email protected]

Companies API

Get company information and metadata

Files API

Access raw scrape files (screenshots, markdown, HTML)

API Reference

​Overview

​Get Pricing Structure

​Latest Version (Default)

​Specific Version

​Period Query

​Multiple Pages

​Response Structure

​Response Fields

​Error Responses

​Company Not Found

​Page Not Found

​Version Not Found

​Period Not Found

​Pricing Models

​Billing Types

​Discount Categories

Annual Discount

Volume Discount

Education Discount

Nonprofit Discount

Startup Discount

Promotional

​Use Cases

Competitive Analysis

Pricing Research

Market Intelligence

Pricing Strategy

​Rate Limiting

​Related Resources

Companies API

Files API

Overview

Get Pricing Structure

Latest Version (Default)

Specific Version

Period Query

Multiple Pages

Response Structure

Response Fields

Error Responses

Company Not Found

Page Not Found

Version Not Found

Period Not Found

Pricing Models

Billing Types

Discount Categories

Use Cases

Rate Limiting

Related Resources