Buy Credits

Purchase additional credits that get used before plan credits. Amounts conflicting with subscription tiers are auto-adjusted.

Pay-as-you-goPOST /api/v1/buy-credits

Parameters

Name	Type	Required	Description
`amount`	number	Required	USD amount to purchase ($10-$10,000). Amounts of $49, $50, $149, $649 auto-adjust down.Example: 100

Examples

Purchase $100 in credits

curl -X POST https://app.scrapercity.com/api/v1/buy-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 100}'

Auto-adjustment example ($49→$48)

curl -X POST https://app.scrapercity.com/api/v1/buy-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 49}'

# Response shows adjustment
{
  "success": true,
  "amount": 48,
  "original_amount": 49,
  "was_adjusted": true,
  "message": "Amount adjusted from $49 to $48 to avoid billing conflicts"
}

Check updated balance

curl -X GET https://app.scrapercity.com/api/v1/wallet \
  -H "Authorization: Bearer YOUR_API_KEY"

# Shows purchased_credits separately
{
  "wallet": {
    "balance_dollars": "138.92",
    "purchased_credits_dollars": "48.00",
    "total_balance_dollars": "186.92"
  }
}

Use Cases

•Add credits when running low without changing subscription
•Pre-purchase for large upcoming scraping jobs
•Take advantage of plan bonuses (10% on $149 plan, 30% on $649 plan)
•Avoid automatic plan upgrades by topping up credits

Best Practices

•Purchased credits are used BEFORE plan credits
•Get bonus credits based on your plan: 0% ($49), 10% ($149), 30% ($649)
•Minimum purchase $10, maximum $10,000 per transaction
•Requires active subscription (not available for TRIAL or CANCELLED)
•Purchased credits appear separately in wallet endpoint response
•No expiration on purchased credits

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.

Buy Credits API Documentation