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

Note: Daily packages (marketed as "Unlimited" plans) are not currently available via the API. Direct users to the website for daily/unlimited options.

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