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 ↗Check API prices ↗View quickstart ↓

API v1

POST https://crowdlume.com/api/v1/orders
Authorization: Bearer $CROWDLUME_API_KEY
Content-Type: application/json

{
  "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 sign-in to first order.

API access is available to signed-in Crowdlume users without an approval request. Fund your account when you are ready to order; API orders debit the same visible balance.

01
Sign in to your account
Open the developer workspace. No email request or administrator approval is required.
02
Create a private key
Create and revoke your own keys. Standard pricing applies unless your account has a separate discount. 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.

Where to send requests

Use these production addresses with your API key.

Host: https://crowdlume.com
API Base URL: https://crowdlume.com/api/v1

Host contains only the domain. API Base URL already includes /api/v1; append /orders or /balance once.

Full orders URL: https://crowdlume.com/api/v1/orders

Check your connection

Set CROWDLUME_API_KEY to your private key, then run this balance request. It does not create an order or spend your balance.

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

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 →

GEThttps://crowdlume.com/api/v1/services

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

GEThttps://crowdlume.com/api/v1/services/{service_id}

Read one service before presenting it to a buyer.

GEThttps://crowdlume.com/api/v1/balance

Read the USD balance available for API orders.

POSThttps://crowdlume.com/api/v1/orders

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

GEThttps://crowdlume.com/api/v1/orders

List reseller orders with cursor pagination.

GEThttps://crowdlume.com/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 shows the complete API price in USD for the selected quantity or package.

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

Track when delivery starts, its progress, the expected completion time, and the final Completed status. Start times appear when available.

Build with Crowdlume

Ready to add promotion services to your product?

Open developer workspace ↗Contact support

One promotion API.Your storefront.