Why PSRESTful?

PSRESTful is a RESTful proxy and enrichment layer built on top of PromoStandards, the promotional products industry’s open standards for supplier integration. It converts every SOAP/XML endpoint into a clean JSON REST API, unifies 500+ suppliers behind a single interface, and adds capabilities that PromoStandards does not provide — including product search, image processing, caching, compression, and multi-tenant support.

The Problem with Direct PromoStandards Integration

PromoStandards has driven tremendous adoption across the promotional products industry, but integrating directly with supplier SOAP endpoints comes with real challenges:

• SOAP/XML complexity — Every request requires building XML envelopes, parsing WSDL files, and handling namespaces. Modern web and mobile applications expect JSON.
• Supplier implementation quirks — Each supplier interprets the specification slightly differently, so code that works with one supplier may break with another.
• Inconsistent Part IDs across services — The same product variant can have different Part IDs in the Media, Inventory, and PPC services, making it difficult to correlate data.
• No caching layer — Fetching full product catalogs from suppliers is slow. Without caching, catalog imports can take hours instead of minutes.
• No image processing or product search — PromoStandards provides raw media URLs but no tools for background removal, decoration mockups, color analysis, or full-text product search.

PSRESTful builds on PromoStandards — not against it. Every supplier endpoint still follows the PromoStandards specification under the hood. PSRESTful simply removes the friction.

One API for 500+ Suppliers

Instead of maintaining separate SOAP integrations for each supplier, you make a single REST call to PSRESTful and get back clean JSON.

PSRESTful supports all major PromoStandards services:

Every response is clean JSON. No XML parsing. No WSDL files.

Beyond PromoStandards

• Products API — Full-text product search, detailed product data with expandable pricing, inventory, and media in a single call
• Suppliers API — Supplier directory with Shopify-readiness flags, credential availability, and decoration support metadata
• Brands API — Brand listings organized by supplier
• Categories API — Product categorization for filtering and organization
• Decorations API — Decoration methods and pricing by supplier, including setup fees and location options
• Part ID Mappings — Cross-reference Part IDs across Media, Inventory, and PPC services to resolve the inconsistency problem
• Web Scraper — Extract packaging dimensions, case pack quantities, and weight data from supplier websites
• Product Classifications — Pre-mapped product types for Shopify, Google Shopping, Amazon, Avalara, and TaxJar

Image Processing with PSMEDx

PSMEDx (PromoStandards Media Extended) is a suite of image processing APIs purpose-built for promotional products. No third-party image service handles the specific needs of this industry — virtual product mockups, Pantone color matching, decoration placement detection — so PSRESTful provides them natively.

• Background Removal — Remove backgrounds from product images for clean e-commerce listings
• Product Decoration — Apply customer artwork onto blank product images to generate virtual mockups
• Vectorization — Convert raster logos to SVG vector format for screen printing and embroidery
• Color Analysis and Pantone Matching — Extract dominant colors from images and find the nearest Pantone match
• Image Classification — Determine whether a product image is blank or decorated, single-part or group shot
• Bounding Box Detection — Automatically find decoration areas on product images for consistent artwork placement

See the full PSMEDx API reference.

Built for Performance

Intelligent Caching

PSRESTful caches responses based on how frequently each data type changes:

• Product data — 1 day to 1 week depending on the endpoint
• Media content — 1 week for individual products, 1 day for modified-since queries
• PPC (pricing) — 1 week for configuration data
• Inventory — 4 hours (balances freshness with performance)
• Transactional services — Never cached (orders, shipments, invoices always go direct)

Need fresh data? Add a Cache-Control: no-cache header to bypass the cache for any request. See Caching for details.

Compression

PSRESTful supports Zstandard, Brotli, and gzip compression. For large payloads like product catalogs and pricing configurations, compression reduces bandwidth by 50-90%. Send Accept-Encoding: zstd, br, gzip and the server selects the best option automatically. See Compression.

Environments

Switch between production and sandbox environments with a single query parameter — environment=PROD or environment=STAGING. No separate base URLs or configurations needed. See Environments.

Security and Access Control

Authentication Methods

See Authentication for setup instructions.

Role-Based Access Control

PSRESTful provides 5 roles with granular dashboard permissions — Admin, Developer, Operations, Product Analyst, and Customer Support. Each role controls access to API keys, data explorer, orders, product analytics, and account settings. See Roles & Permissions.

Credential Security

Supplier credentials managed through the Credentials API are encrypted at rest and never exposed in API responses. Each sub-account can have independent supplier credentials with full audit trail support.

Built for SaaS Platforms

If you run a SaaS platform that provides promotional products capabilities to your customers, PSRESTful’s Sub-Accounts model lets you manage everything from a single parent account:

• Create sub-accounts for each of your customers programmatically
• Generate per-sub-account API keys with independent rate limits
• Map sub-accounts to your internal customer IDs via external_customer_id
• Configure per-customer supplier credentials for customer-specific pricing and transactional access
• Track usage centrally while maintaining isolation between customers

Sub-Accounts require an Enterprise plan. See Sub-Accounts API and Credentials API.

Developer Experience

• Interactive API Reference — Full Swagger/OpenAPI documentation at api.psrestful.com/docs
• Postman Collection — Ready-to-import collection for quick testing
• Code Examples — Python, JavaScript, and cURL examples on every guide page
• 20+ How-To Guides — Step-by-step guides for every PromoStandards service and common workflows
• Rate Limit Headers — Every response includes X-RateLimit-Limit and X-RateLimit-Remaining so you always know your usage

Plans

See Rate Limits for details on headers, burst behavior, and upgrading.

Get Started

1. Create an account at psrestful.com
2. Get your API key from the dashboard
3. Explore the API — try the Interactive API Reference or follow one of the how-to guides
4. Need help? Contact us at devs@psrestful.com