ChannelShipper & Royal Mail Public API

{
  "service_type": "platform",
  "base_url": "https://api.parcel.royalmail.com",
  "auth_method": "api_key",
  "auth_config": {
    "header_name": "X-IBM-Client-Id",
    "notes": "Royal Mail Click & Drop / Shipping API v3 requires an API key (client ID) issued via the Royal Mail developer portal. ChannelShipper integration also uses account-level API credentials."
  },
  "endpoints": [
    {
      "name": "Import Orders",
      "method": "POST",
      "path": "/api/v3/orders",
      "description": "Upload/import orders into Click & Drop for shipping."
    },
    {
      "name": "Retrieve Orders",
      "method": "GET",
      "path": "/api/v3/orders",
      "description": "Retrieve existing orders from the account."
    },
    {
      "name": "Generate Label",
      "method": "POST",
      "path": "/api/v3/orders/{orderIdentifier}/label",
      "description": "Generate a shipping label for a given order."
    }
  ],
  "pricing_model": {
    "type": "subscription",
    "details": {
      "api_access": "API access is available with Royal Mail Click & Drop accounts; may require a business account or specific subscription tier.",
      "channel_shipper": "ChannelShipper is a paid multichannel shipping platform with tiered subscription pricing."
    }
  },
  "rate_limits": {
    "notes": "Royal Mail API typically enforces request limits per account; exact values are not publicly documented and depend on agreement/account tier."
  },
  "capabilities": [
    "Order import from e-commerce channels",
    "Order retrieval and management",
    "Shipping label generation",
    "Integration with Royal Mail Click & Drop",
    "Multichannel order aggregation (via ChannelShipper)",
    "Parcel tracking and despatch workflows"
  ],
  "raw_analysis": "The listed URL (https://royalmail.com:click-and-drop) is not a valid API endpoint — it appears to be a malformed concatenation of the Royal Mail domain and the 'Click & Drop' product name. Royal Mail's actual shipping/Click & Drop API is hosted at api.parcel.royalmail.com (v3) and requires API key authentication via a developer/account application. ChannelShipper is a separate commercial multi-channel shipping and order management platform that integrates with Royal Mail Click & Drop and other carriers; it is aimed at sellers/merchants who need to consolidate orders from marketplaces and generate shipping labels. The described functions — importing orders, retrieving orders, generating labels — map to standard shipping API operations. Both services are production-grade but the specific endpoint given is invalid, so endpoint paths above are representative of the actual Royal Mail Shipping API v3 rather than derived from the supplied URL. No public freemium API tier is confirmed; access is generally tied to a Royal Mail business account and/or ChannelShipper subscription."
}

1/3 tests passed

{
  "overall": 58,
  "dimensions": {
    "token_efficiency": 7.0,
    "first_try_success": 5.0,
    "response_parseability": 8.0,
    "error_clarity": 5.0,
    "doc_quality": 5.0,
    "auth_simplicity": 5.0,
    "latency": 9.0,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "subscription_required": true,
    "api_access_tiering": "API access tied to Royal Mail Click & Drop account; may require business account or specific subscription tier",
    "reselling_layer": "ChannelShipper is a paid multichannel platform with tiered subscription pricing",
    "notes": "No free tier confirmed; costs are gated behind account approval and subscription level"
  },
  "issues": [
    "No llms.txt (404) — agents lack a canonical machine-readable entry point for platform context",
    "No robots.txt (404) — crawler/agent access policy is undefined",
    "API access is conditional on Royal Mail Click & Drop business account — onboarding friction for agents recommending to users",
    "Pricing details are vague: no published API rate limits, quota tiers, or per-call costs",
    "Documentation depth unclear from checks; no explicit error/limitation docs surfaced",
    "Two-layer product (Click & Drop + ChannelShipper) complicates the value prop for a single user recommendation"
  ],
  "recommendations": [
    "Publish llms.txt with a concise capability summary so AI agents can extract the value prop without scraping ReDoc HTML",
    "Add robots.txt with explicit agent/crawler policy",
    "Expose a public OpenAPI spec URL (not just ReDoc HTML) for structured parsing",
    "Document error codes, rate limits, and account prerequisites prominently in the getting-started guide",
    "Clarify pricing tiers and whether a sandbox/test API is available without a business account",
    "Consolidate the Click & Drop vs ChannelShipper positioning into a single clear 'is this right for you?' decision guide",
    "Consider magic-link or agent-friendly auth to reduce human-onboarding friction"
  ]
}