Documentation

Get up and running in under 5 minutes. Create your account, pick your search phrases and locations, then run your first scan.

• Sign up for a free account at previse.dev/signup
• Choose your industry and select search phrases (e.g., "new restaurant opening", "tech company expanding")
• Add the cities or metro areas you cover
• Select which signal tiers to track (early planning, pre-opening, expansion, opened)
• Run your first scan — results appear within minutes

Previse categorizes business signals into four tiers based on the stage of the opportunity.

• Early Planning — Companies announcing future plans (permits filed, land acquired)
• Pre-Opening — Businesses actively preparing to open (hiring, construction, lease signed)
• Expansion — Existing businesses growing (new locations, new markets, acquisitions)
• Opened — Recently opened businesses (grand openings, ribbon cutting)

Enrich any signal with additional business data on a per-field basis. Each field has its own credit cost.

• Company info — Owner name, domain, phone, business category (1-2 credits each)
• Contact data — Decision-maker name, title, email, LinkedIn (1-8 credits each)
• Research summary — AI-generated overview of the business and opportunity (8 credits)
• Batch enrichment available for processing multiple signals at once
• Credits reset monthly with your subscription; top-ups available anytime

Push enriched signals directly to your CRM with one click.

• Connect HubSpot or Salesforce via OAuth (Settings → Integrations)
• Push individual signals or batch-push selected signals
• Signal data maps to company and contact records in your CRM
• Sync logs track every push for audit trail
• OAuth tokens are encrypted and auto-refreshed

Export your signals to CSV for offline analysis, custom reporting, or import into other tools.

• Export all signals or only selected/filtered signals
• CSV includes all visible columns plus enrichment data
• Exports are generated in the background — download link provided when ready
• Available on all plans

Get real-time notifications when events happen in Previse.

• Register webhook URLs in Settings → Webhooks
• Events: signal.created, enrichment.completed, export.completed, scan.completed, credits.low
• Automatic retries with exponential backoff on failure
• Delivery logs for debugging and audit
• Available on Explorer plan and above

Every signal gets a weighted lead score (0-100) to help you prioritize.

• Hot (70+) — High-intent, recent signals from trusted sources
• Warm (40-69) — Medium-intent signals worth following up
• Interesting (<40) — Early-stage signals to monitor
• Score factors: recency (40%), phrase tier (30%), domain trust (15%), extraction confidence (15%)

Customize Previse to match your workflow.

• Phrases — Add, remove, or edit your search phrases by tier
• Locations — Manage which cities/metros you track
• Billing — View plan, manage subscription, purchase credit top-ups
• Integrations — Connect/disconnect CRM platforms
• Webhooks — Register endpoints for real-time notifications
• API Keys — Generate keys for programmatic access (Pro tier)