Navigation
resources
FAQ
Which freelance platforms does Prospector support?
Prospector currently supports Upwork and Freelancer.com. Both platforms are integrated through their official APIs using OAuth 2.0. Platform-specific setup instructions are available for Upwork and Freelancer. Additional platforms are planned but not yet announced.
Can Prospector submit proposals automatically without my review?
Yes, but it requires explicit opt-in. By default, Prospector pauses at the review stage and waits for you to approve each draft. If you want automatic submission, set the auto_pipeline_min score threshold in your scoring configuration and create an auto_submit rule in the rules engine. Only leads that pass both the score threshold and all rules will be submitted without review.
Automatic submission is powerful but carries risk. A poorly configured scoring model or overly permissive rules can send proposals to jobs that are a bad fit. Start with a high threshold (85+) and monitor results for a few weeks before lowering it.
How often does Prospector scan for new leads?
The scan interval is configurable per platform. The default is every 30 minutes. You can set it as low as 15 minutes, though shorter intervals increase the chance of hitting platform API rate limits. You can also trigger manual scans at any time through the CLI or dashboard.
Does Prospector use my Upwork or Freelancer connects?
On Upwork, submitting a proposal costs “Connects” (Upwork’s internal currency). Prospector submits proposals through the same mechanism as doing it manually, so yes, each submitted proposal uses your Connects. Prospector tracks your remaining Connects balance and can be configured to pause auto-submission when your balance drops below a threshold.
Freelancer does not use a similar currency system, so this is not a concern on that platform.
What happens if a job posting closes before my proposal is submitted?
If Prospector attempts to submit a proposal to a closed posting, the platform API returns an error. Prospector marks the proposal as submission_failed with the reason “posting closed” and moves on. You are notified through your configured notification channel. No Connects or credits are consumed for failed submissions.
Can I use Prospector with multiple freelancer accounts?
Each GhostStack account supports one connection per platform. If you have multiple Upwork profiles (e.g., a personal account and an agency account), you would need separate GhostStack accounts for each. This is a limitation of how platform OAuth scopes work rather than a Prospector design choice.
How does Prospector handle rate limits on freelance platforms?
Prospector tracks rate limit headers from platform APIs and automatically throttles requests to stay within limits. If a rate limit is hit, Prospector queues the request and retries after the platform’s specified cooldown period. You can reduce the likelihood of rate limit issues by increasing your scan_interval or reducing max_results_per_scan in your platform configuration.
Is my proposal text stored on GhostStack servers?
Yes. Proposal drafts and submitted proposals are stored in your GhostStack account so you can review history, track win rates, and improve your templates over time. All stored proposal text is encrypted at rest. See the Security page for details on encryption and data retention policies.
Can I export my data from Prospector?
You can export your leads, proposals, and contract data through the REST API. There is no one-click export button in the dashboard currently, but the API’s list endpoints support pagination and can be scripted to pull your complete history.
# Export all leads as JSON
ghoststack prospector leads list --format json --per-page 100 --all > leads.json
What AI model generates the proposal drafts?
Prospector uses the AI model configured in your GhostStack account settings. The default is the latest available model through GhostStack’s AI infrastructure. You do not need a separate API key for AI features; they are included with your Prospector subscription. The model used for generation is logged with each proposal for reproducibility.
How do I delete all my Prospector data?
Go to Settings > Privacy > Delete My Data in the GhostStack dashboard. This permanently removes all leads, proposals, contracts, scoring history, and configuration. Platform credentials stored in Vault must be deleted separately through the Vault interface. Data deletion is irreversible and takes effect within 24 hours.
Can I use Prospector’s API to build my own dashboard?
Yes. The REST API exposes all of Prospector’s data and actions programmatically. You can build custom dashboards, integrate with your existing tools, or create automated workflows using the API alongside webhook events. The API uses standard REST conventions with JSON payloads, so any HTTP client works.