Crowdlume for resellers

One promotion API.
Your storefront.

Offer Crowdlume services inside your own product. Query account-specific prices, place prepaid orders, and return useful delivery status without handling fulfillment integrations yourself.

Manage API access ↗View quickstart ↓

API v1

POST /api/v1/orders
Authorization: Bearer $CROWDLUME_API_KEY

{
  "service_id": "auto-instagram-likes-economy",
  "target_url": "https://instagram.com/p/example",
  "quantity": 500,
  "client_order_id": "store-order-10482"
}

RESTJSON over HTTPS

CLIHuman + JSON output

MCPLocal stdio server

LiveService-specific quantity limits

Quickstart

From approval to first order.

Reseller access is attached to a verified Crowdlume account. Fund that account once, then API orders debit the same visible balance.

01
Request reseller access
Sign in first, then contact support with your store or application name.
02
Create a private key
Approved accounts can create and revoke keys at any time. A new secret is shown once.
03
Read the live catalog
Use the returned quantity range or opaque package ID and the price assigned to your account.
04
Create and track
Send a unique client order ID. Retrying the same request returns the original order instead of charging twice.

API reference

A small, stable ordering surface.

All endpoints use HTTPS and JSON. API responses contain Crowdlume product and customer-facing order data only. Download OpenAPI 3.1 →

GET/api/v1/services

List services, ordering modes, packages, and your reseller prices.

GET/api/v1/services/{service_id}

Read one service before presenting it to a buyer.

GET/api/v1/balance

Read the USD balance available for API orders.

POST/api/v1/orders

Create one balance-funded order with your own client order ID.

GET/api/v1/orders

List reseller orders with cursor pagination.

GET/api/v1/orders/{order_id}

Read progress, expected timing, and completion.

Authentication

Bearer keys with explicit scopes.

Send your key in the `Authorization` header. Keys are stored as one-way hashes, can be revoked independently, and never belong in browser code.

curl https://crowdlume.com/api/v1/balance \
  -H "Authorization: Bearer $CROWDLUME_API_KEY"

Order safety

Idempotent by your order ID.

`client_order_id` must be unique inside your reseller account. A matching retry returns the existing result. Reusing it with different order data returns a conflict and never creates a second charge.

{
  "ok": true,
  "duplicate": false,
  "data": {
    "id": "cl_…",
    "status": "In progress"
  }
}

CLI + MCP

The same API for operators and AI tools.

The Crowdlume CLI supports readable terminal output and `--json`. Its MCP mode exposes six tools for catalog search, balance checks, order creation, and order tracking. Business rules remain on the Crowdlume server.

No API key is bundled into the package.
MCP uses stdio, so protocol output stays isolated from logs.
The order-creation tool is clearly marked as a balance-spending action.

Install and connect

npm install -g \
  https://crowdlume.com/downloads/crowdlume-cli-1.0.0.tgz

export CROWDLUME_API_KEY="your_key"
crowdlume services list
crowdlume balance
crowdlume mcp

Catalog contract

Two ordering modes

Automated services accept an exact quantity inside the listed range. Community campaigns accept only the opaque package IDs returned for that service.

Account pricing

One API total

Every quote is the complete reseller price in USD. Internal costs and fulfillment routing are not part of the public contract.

Usage protection

Rate and access controls

Each account receives a bounded request rate. Suspended accounts and revoked keys stop immediately without affecting other customers.

Public status

Useful delivery updates

Responses show publication or start time when available, progress, expected completion, and Completed—never private routing information.

Build with Crowdlume

Ready to add promotion services to your product?

Sign in, request reseller approval, and create your first private API key from the same account that holds your ordering balance.

Open developer workspace ↗Contact support

One promotion API.Your storefront.