# Zolpix

> Zolpix publishes a multilingual social media service catalog. This public integration is read-only; it cannot place orders, take payments, manage accounts, or deliver social engagement.

## When to use this

Use Zolpix to discover which social platforms and service packages are currently published, compare package quantities and base prices, and find the matching human-facing product page. Use the locale parameter to retrieve published Turkish (tr), English (en), or Croatian (hr) content. Do not infer that a displayed package is available for live purchase: inspect purchase_mode and live_purchase_available on each package. Do not promise organic growth, verified followers, delivery times, refunds, or platform endorsement unless the returned published terms explicitly support the claim.

## How to call

No authentication is required. Send GET to /api/v1/catalog?locale=en with Accept: application/json. The default locale is en. The response contains published platforms, services, and packages; unpublished entities and private customer information are excluded. Prices are integer minor units of TRY, the catalog's accounting base currency. They are informational catalog prices, not checkout quotes or a payment instruction. Website currency preferences do not alter this API. Visit the returned service URL for the current human purchase flow. Obtain the user's explicit authorization before any purchase; this API offers no purchase operation.

## Limits and errors

The catalog API allows 60 requests per minute per IP. Responses include structured RateLimit-Policy and RateLimit fields (IETF HTTPAPI rate-limit draft format, with reset in seconds), plus legacy X-RateLimit fields. A 429 response includes Retry-After; respect it and retry later. Unsupported or malformed locale values return JSON with HTTP 422. Only GET and HEAD are supported. No reseller API, MCP server, SDK, order submission, payment, or customer-account API is advertised.

## Versioning and deprecation policy

The current stable API is /api/v1. Additive fields may be introduced within v1; clients should ignore unknown response fields. Breaking changes require a new major URL version. No endpoint is currently deprecated and no sunset date is scheduled. If v1 is retired, Zolpix will publish a dated notice in this developer guide and llms.txt at least 90 days before removal and include the standard Deprecation (RFC 9745), Sunset (RFC 8594), and Link rel="deprecation" response headers on affected endpoints. No deprecation headers are sent before an actual deprecation decision. Bookmark this guide and review it before upgrading clients.

## Command-line client

The official dependency-free Zolpix CLI is published on npm as `zolpix-cli` and requires Node.js 22 or later. Install with `npm install -g zolpix-cli` or run `npx zolpix-cli catalog --locale en`. The registry package is https://www.npmjs.com/package/zolpix-cli. Alternatively, download https://zolpix.com/cli/zolpix.mjs, inspect the file, then run `node zolpix.mjs catalog --locale en`, `node zolpix.mjs spec`, or `node zolpix.mjs docs --locale en`. It uses the same public read-only API and cannot submit purchases. Output is JSON for catalog/spec, errors go to stderr, and HTTP 429 reports Retry-After with exit code 2. The npm package and direct-download script are maintained by Zolpix. Both use the same read-only client.

## Resources

- [Türkçe geliştirici rehberi](https://zolpix.com/tr/developers)
- [English developer guide](https://zolpix.com/en/developers)
- [Hrvatske upute za razvojne programere](https://zolpix.com/hr/developers)

- [Official npm CLI](https://www.npmjs.com/package/zolpix-cli): `npm install -g zolpix-cli`.
- [Official CLI](https://zolpix.com/cli/zolpix.mjs): Download the Node.js command-line client.
- [Developer guide](https://zolpix.com/developers): Public API usage and limits.
- [OpenAPI 3.1 specification](https://zolpix.com/openapi.json): Typed operation and response schemas.
- [Published catalog](https://zolpix.com/api/v1/catalog?locale=en): Read-only English catalog.
- [Sitemap](https://zolpix.com/sitemap.xml): Public website pages.

## HTTP quickstart

```sh
curl --fail-with-body --max-time 20 -H 'Accept: application/json' 'https://zolpix.com/api/v1/catalog?locale=en'
```

## Response fields

A successful response has locale, read_only, price_notice and platforms. Each platform contains services; each service contains packages. Read price_minor as TRY minor units and inspect is_sample, purchase_mode and live_purchase_available before discussing availability. The OpenAPI document defines the complete response; HTTP 422 means invalid locale and HTTP 429 requires waiting for Retry-After.

- [Pricing](https://zolpix.com/en/pricing)
- [API documentation](https://zolpix.com/docs)
- [OpenAPI JSON](https://zolpix.com/openapi.json)
- [JSON sandbox](https://zolpix.com/api/v1/catalog?locale=en)

## Trust and contact

- [Zolpix](https://zolpix.com/en/).
- [About Zolpix](https://zolpix.com/about).
- [Contact Zolpix](https://zolpix.com/contact).
- [Privacy](https://zolpix.com/privacy).