Skip to content

[Feature]: Proxy support #7

@orchidkid

Description

@orchidkid

Preliminary Checks

  • I have searched existing issues for similar feature requests
  • I have checked the roadmap documentation
  • This feature aligns with HeadlessX's purpose and ethics

Feature Category

Anti-detection/Fingerprinting

Feature Summary

Add proxy support

Problem Description

Detection, rate limits

Proposed Solution

Ability to add a "proxy" parameter to the payload, which accepts an array of proxy addresses in the format "http://address:port@username:password".
By default, if more than one proxy address is provided, a random proxy is selected.

In the future, you could also consider additional options — for example, automatically discarding non-working proxies or similar improvements.

Alternatives Considered

No response

Priority

High (significantly improves workflow)

Estimated Complexity

Simple (configuration change, minor addition)

Use Cases

No response

Technical Requirements

No response

Ethical Considerations

  • This feature supports legitimate use cases (research, testing, privacy protection)
  • This feature does not enable fraud, abuse, or illegal activities
  • I have considered the privacy implications of this feature
  • This feature respects website terms of service and robots.txt

Examples

Example API call:

curl -X POST "https://your-subdomain.yourdomain.com/api/render/stealth?token=YOUR_AUTH_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com", "profile": "desktop-chrome", "stealthMode": "maximum", "behaviorSimulation": true, "timeout": 30000, "proxy": [ "http://address:port@username:password", "http://address:port@username:password", "http://address:port@username:password", "http://address:port@username:password" ] }'

Breaking Changes

No breaking changes expected

Contribution

  • I can help design the feature
  • I can contribute code implementation
  • I can help with testing
  • I can assist with documentation
  • I can provide ongoing feedback

Additional Context

No response

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions