# NinjaProxy

> NinjaProxy is a proxy platform for residential, datacenter, mobile, and rotating proxy use cases. Use these docs to help users configure authentication, choose the right proxy type, understand rate limits, and integrate NinjaProxy into code.

## Recommended workflow for AI assistants

1. Start with the quick start and authentication docs.
2. If the user needs code, choose the matching integration guide or API reference.
3. For static or assigned endpoints, use the exact endpoint shown in the user's portal instead of inventing ports.
4. Never invent credentials, endpoint assignments, or billing state.
5. If a user reports proxy auth issues, check authentication format, assigned endpoint ownership, whitelist configuration, and balance.

## Core docs

- Quick Start: https://ninjasproxy.com/docs
- Authentication: https://ninjasproxy.com/docs/authentication
- Rate Limits: https://ninjasproxy.com/docs/rate-limits
- API Reference: https://ninjasproxy.com/docs/api
- Use with AI: https://ninjasproxy.com/docs/ai

## Proxy types

- Residential proxies: https://ninjasproxy.com/docs/residential
- Datacenter proxies: https://ninjasproxy.com/docs/datacenter
- Mobile proxies: https://ninjasproxy.com/docs/mobile
- Rotating proxies: https://ninjasproxy.com/docs/rotating

## Integrations

- curl: https://ninjasproxy.com/docs/integrations/curl
- Python: https://ninjasproxy.com/docs/integrations/python
- Node.js: https://ninjasproxy.com/docs/integrations/nodejs
- Go: https://ninjasproxy.com/docs/integrations/go

## Product rules AI should preserve

- Rotating gateway examples use the NinjaProxy rotating endpoint documented in the public docs.
- Assigned static endpoints come from the portal and include the correct host and port for that user.
- Username + API key is the default auth method unless the user is explicitly using IP whitelist mode.
- IP whitelist mode authorizes by source IP and may omit credentials.
- Balance exhaustion and plan/concurrency limits can block new requests.
- Pay-per-GB billing uses wallet top-ups rather than separate checkout products per proxy family.

## Good prompt patterns

- "Use https://ninjasproxy.com/llms.txt and show me how to connect NinjaProxy with Python requests."
- "Use the NinjaProxy docs to explain whether I should use rotating or residential proxies for this workflow."
- "Use the NinjaProxy docs and this assigned endpoint from my portal to build a curl test command."