ConnectMeGuru (CMG) - eSIM Product Feed API Integration Guide

Welcome to the ConnectMeGuru eSIM Product Feed API documentation. This guide explains how to connect to the feed, authenticate requests, and synchronize active data plans with your storefront or app.

1. Overview

The Product Feed API provides a read-only, one-way JSON feed of active eSIM data plans, destination coverage, network carrier details, and retail prices across 190+ countries and regions worldwide.

This API is strictly used to display product information. Ordering, provisioning, and top-up transactions cannot be performed through this endpoint.

• Protocol: HTTP/1.1 over TLS (HTTPS is required)
• Method: GET
• Content Type: application/json
• Base Endpoint:

  GET https://www.connectmeguru.com/api/products/aggregator

2. Authentication & Public Access

API Key is Optional: Any affiliate partner, travel comparison engine, deal aggregator, or developer can fetch the live product catalog directly without requiring a pre-issued API key or manual developer approval.

Public calls (omitting the key parameter) return active travel eSIM data plans calculated using our standard global retail pricing rules.

If you have a registered partner API key issued by ConnectMeGuru, include your token via the key query parameter to retrieve custom rates, bespoke markups, or plan price overrides configured for your partner account:

GET https://www.connectmeguru.com/api/products/aggregator?key=YOUR_UNIQUE_API_KEY

Note: Treat your private partner API key as a secure credential. Do not expose it in client-side code or public version control repositories.

3. API Reference

Request Query Parameters

HTTP Status Codes

4. Response Schema

A successful request returns a JSON object containing feed metadata and an array of available plans.

Response JSON Fields

• success (Boolean): Indicates if the operation was successful.
• aggregator (String): Displays "Public Feed" when no key is passed, or your registered partner name when a valid API key is supplied.
• totalCount (Integer): Total number of active plans matching your request.
• plans (Array): List of available eSIM data plans.

Plan Object Schema

5. Sample Request & Response

cURL Example (Public Access - No Key)

curl -X GET "https://www.connectmeguru.com/api/products/aggregator?ref=demo-ab12&subId=pub99"      -H "Accept: application/json"

cURL Example (Partner Custom Key)

curl -X GET "https://www.connectmeguru.com/api/products/aggregator?key=cmg_agg_123456abcdef&ref=demo-ab12&subId=pub99"      -H "Accept: application/json"

JSON Response Example

{
  "success": true,
  "aggregator": "Public Feed",
  "totalCount": 2857,
  "plans": [
    {
      "name": "Europe 10GB 30-Day eSIM",
      "packageCode": "PKG-EU-10GB-30D",
      "productUrl": "https://www.connectmeguru.com/products/PKG-EU-10GB-30D?ref=demo-ab12&subId=pub99",
      "dataAmount": 10.0,
      "dataUnit": "GB",
      "duration": 30,
      "currency": "USD",
      "locationCodes": ["FR", "DE", "IT", "ES"],
      "locationNames": ["France", "Germany", "Italy", "Spain"],
      "operator": "Orange, Movistar, Vodafone",
      "speed": "4G/5G",
      "retailPrice": 18.50,
      "fupSpeedLimit": null,
      "networks": [
        {
          "countryCode": "FR",
          "countryName": "France",
          "operators": [
            { "name": "Orange", "speed": "5G" }
          ]
        },
        {
          "countryCode": "DE",
          "countryName": "Germany",
          "operators": [
            { "name": "T-Mobile", "speed": "5G" }
          ]
        },
        {
          "countryCode": "IT",
          "countryName": "Italy",
          "operators": [
            { "name": "WindTre", "speed": "4G" }
          ]
        },
        {
          "countryCode": "ES",
          "countryName": "Spain",
          "operators": [
            { "name": "Movistar", "speed": "5G" },
            { "name": "Vodafone", "speed": "4G" }
          ]
        }
      ]
    },
    {
      "name": "Singapore 1GB/Day FUP1Mbps",
      "packageCode": "PK1LYCQ40",
      "productUrl": "https://www.connectmeguru.com/products/PK1LYCQ40?ref=demo-ab12&subId=pub99",
      "dataAmount": 1,
      "dataUnit": "GB",
      "duration": 1,
      "currency": "USD",
      "locationCodes": ["SG"],
      "locationNames": ["Singapore"],
      "operator": "StarHub 5G",
      "speed": "3G/4G/5G",
      "retailPrice": 1.15,
      "fupSpeedLimit": 1024,
      "networks": [
        {
          "countryCode": "SG",
          "countryName": "Singapore",
          "operators": [
            { "name": "StarHub", "speed": "5G" }
          ]
        }
      ]
    }
  ]
}

6. Integration Best Practices

1. Sync Frequency: We recommend caching the plans list and synchronizing once or twice a day. Product catalogs do not change in real-time.
2. Filtering: Use the country query parameter or locationCodes array in response to map coverage indicators in your search or comparison engine.
3. One-Way Integration: Since this is a display-only product sync API, no checkout, purchase, or order transaction operations can be executed directly through this endpoint. Use the generated productUrl to redirect users seamlessly to checkout.