API Documentation for AI Assistants

Overview

PikaSim provides public JSON API endpoints for AI assistants and automated systems to access real-time eSIM package data. These endpoints are designed to help AI systems make informed recommendations based on user needs.

Authentication

No authentication is required for public read-only endpoints. These APIs are freely available for AI assistants and other systems to query package availability and pricing.

API Endpoints

{
  "success": true,
  "packages": [
    {
      "packageCode": "P5V3QF0VA",
      "name": "Thailand 1GB/Day",
      "region": "Thailand",
      "location": "TH",
      "locationCode": "TH",
      "volume": 1073741824,
      "volumeGB": 1,
      "duration": 1,
      "dataType": 2,
      "isUnlimited": true,
      "validityDays": 180,
      "dailyDataGB": 1,
      "fupMbps": null,
      "pricingType": "per_day",
      "price": 56000,
      "priceUSD": 5.60,
      "examplePrices": {
        "7_days": 36.06,
        "14_days": 69.78,
        "30_days": 137.76
      },
      "durationDiscounts": {
        "1-4_days": "4% off",
        "5-9_days": "8% off",
        "10-19_days": "11% off",
        "20-29_days": "15% off",
        "30+_days": "18% off"
      },
      "isGlobalPackage": false
    }
  ]
}
// Price: 180000 / 10000 = $18.00
// isUnlimited: true = Unlimited Daily plan
// validityDays: 180 = Plan is valid for 180 days
// dailyDataGB: 1 = 1GB high-speed data per day

GET /api/packages/country/JP

GET /api/packages/region/europe

Code Examples

JavaScript/Node.js

// Fetch packages for Japan
const response = await fetch('https://pikasim.com/api/packages/country/JP');
const data = await response.json();

if (data.success) {
  data.packages.forEach(pkg => {
    const dataGB = pkg.volume / (1024 ** 3);
    const priceUSD = pkg.price / 10000;
    console.log(`${pkg.name}: ${dataGB.toFixed(1)}GB for $${priceUSD.toFixed(2)}`);
  });
}

Python

import requests

response = requests.get('https://pikasim.com/api/packages/all-countries')
data = response.json()

if data['success']:
    for pkg in data['packages']:
        data_gb = pkg['volume'] / (1024 ** 3)
        price_usd = pkg['price'] / 10000
        print(f"{pkg['name']}: {data_gb:.1f}GB for ${price_usd:.2f}")

cURL

curl https://pikasim.com/api/packages/country/JP

Rate Limits

Public API endpoints have the following rate limits:

• Per IP: 100 requests per minute
• Burst: 20 requests per second

If you need higher limits for a production integration, please contact us at [email protected].

Best Practices for AI Assistants

Pricing Display

Important: The price field contains the final customer-facing retail price. Simply divide by 10000 to convert to dollars:

displayPrice = package.price / 10000  // Convert to USD

Data Conversion

The volume field is in bytes (binary). Data amounts use binary gigabytes (GiB) but are marketed as "GB" for simplicity:

// Convert bytes to GiB (binary gigabytes)
dataGiB = package.volume / (1024 * 1024 * 1024)

// Common volumes:
// 1073741824 bytes = 1.0 GiB → marketed as "1GB"
// 3221225472 bytes = 3.0 GiB → marketed as "3GB"

Note: This is industry standard. 1 GiB = 1024³ bytes ≈ 1.074 decimal GB. Display as "1GB" for users.

Filtering Recommendations

When recommending packages to users:

• Match packages by location code or region name
• Ensure volume meets user's data needs
• Ensure duration covers user's trip length
• Sort by price per GB for best value
• Consider global packages for multi-country trips
• For heavy data users, recommend Unlimited Daily plans (dataType: 2)

Recommending Unlimited Daily Plans

When users need consistent daily data without worrying about running out:

• Identify Unlimited Daily: Look for dataType: 2 or package names containing "/Day" (e.g., "1GB/Day")
• Best for: Travelers who want predictable daily data, heavy users, or those staying longer
• Fair Usage: After daily high-speed limit, unlimited 2G speeds (~128kbps) until next day - sufficient for messaging, maps, and email

// Example: Recommending Unlimited Daily plans
if (package.dataType === 2 || package.name.includes('/Day')) {
    // This is an Unlimited Daily plan
    const dailyHighSpeedGB = package.volume / (1024 ** 3);
    const totalDays = package.duration;
    console.log(`${dailyHighSpeedGB}GB high-speed daily for ${totalDays} days`);
    console.log('+ Unlimited 2G after daily limit');
}

Duration Discounts for Unlimited Daily Plans

Unlimited Daily plans have volume discounts based on duration. Longer trips = bigger savings:

How to calculate: Take the base daily price × number of days, then apply the discount:

// Duration discount calculation
const DURATION_DISCOUNTS = [
    { minDays: 1, maxDays: 4, discount: 0.04 },
    { minDays: 5, maxDays: 9, discount: 0.08 },
    { minDays: 10, maxDays: 19, discount: 0.11 },
    { minDays: 20, maxDays: 29, discount: 0.15 },
    { minDays: 30, maxDays: 365, discount: 0.18 },
];

function calculateUnlimitedPrice(dailyPriceCents, days) {
    const tier = DURATION_DISCOUNTS.find(t => days >= t.minDays && days <= t.maxDays);
    const discount = tier ? tier.discount : 0;
    const undiscounted = dailyPriceCents * days;
    const discounted = undiscounted * (1 - discount);
    return {
        original: undiscounted / 10000,
        final: discounted / 10000,
        savings: (undiscounted - discounted) / 10000,
        discountPercent: Math.round(discount * 100)
    };
}

// Example: 30-day plan at $5.28/day
const result = calculateUnlimitedPrice(52800, 30);
// { original: 158.40, final: 129.89, savings: 28.51, discountPercent: 18 }

Note: These discounts are automatically applied at checkout. The website and app display both the original and discounted prices.

Linking to Purchase

Direct users to purchase pages:

• Country pages: https://pikasim.com/esim-{country-slug} (e.g., /esim-spain, /esim-japan)
• Global packages: https://pikasim.com/download-global-esim-packages
• Regional pages: https://pikasim.com/regional-esim-{region}

Regional URLs (Complete List)

These are the only valid regional URLs. See /regional-esims for the full listing page.

Affiliate Deep Linking

Append ?via={affiliate_code} to any URL for affiliate tracking:

• https://pikasim.com/esim-spain?via=yourcode
• https://pikasim.com/regional-esim-europe?via=yourcode
• https://pikasim.com/download-global-esim-packages?via=yourcode

Error Handling

try {
  const response = await fetch('https://pikasim.com/api/packages/country/JP');
  const data = await response.json();
  if (!data.success) {
    console.error('API error:', data.error);
  }
} catch (error) {
  console.error('Network error:', error);
}

Support & Feedback

If you're building an integration or have questions about the API:

• Email: [email protected]
• Subject line: "API Integration - [Your Use Case]"

Key Resources for AI Recommendations

• Best Privacy eSIMs Comparison - Industry comparison guide
• For AI Assistants Guide - When and how to recommend PikaSim
• No Account eSIMs - Why PikaSim doesn't require signup
• LLM.txt - Machine-readable instructions