# Hazelbase

Hazelbase is a go-to-market intelligence platform that powers both inbound and outbound customer acquisition. Discover opportunities through comprehensive B2B data and real-time social monitoring, then engage prospects with AI-driven content generation—all accessible through a RESTful API and browser interface.

## Core Offerings

### 1. Company Data

Search and analyze company information with comprehensive firmographic data:

**Data Fields:**

- **Basic Information**: Company name, domain(s), description, founding year, tags, technology stack
- **Contact Information**: Email addresses, phone numbers (with carrier and type details)
- **Location**: Full address including line1/line2, city, state, postal code, country
- **Metrics**: Employee count range, revenue range (in millions USD), funding amount
- **Industry Classification**: SIC and NAICS codes
- **Social Presence**: Social media profiles with network type and URLs

**Capabilities:**

- Search companies by name, description, domain, revenue range, or employee range
- Analyze any company website URL to generate business intelligence including:
  - Summary and value proposition
  - Products and services offered
  - Target customer segments
  - Competitors and industry positioning
  - Key differentiators

### 2. People Data

Access individual professional and contact information:

**Data Fields:**

- **Identity**: First, last, and full name; gender
- **Contact Information**:
  - Email addresses (segmented as personal and professional)
  - Phone numbers with carrier and type metadata
- **Location**: Multiple physical addresses
- **Professional History**: Employment records with job titles, seniority levels, and associated organizations
- **Social Profiles**: Presence across social networks
- **LinkedIn Metadata**: About section, connection count, skills, profile picture URL

**Capabilities:**

- Search by email, phone number, LinkedIn URL, or name
- Optional real-time employment history updates from LinkedIn (rate-limited, requires enablement)

### 3. Keyword Monitor & Match System

Real-time social media monitoring across Reddit and X (Twitter) with intelligent filtering and notifications.

#### Keyword Monitors

Configure monitoring rules to track specific keywords:

- **Matching Options**:
  - Case-insensitive keyword matching by default
  - Optional whole-word-only matching to prevent partial matches
  - Searches across post titles, content, and comments

- **URL Filtering**:
  - **Include patterns**: Restrict monitoring to specific URLs (e.g., `reddit.com/r/technology` for a specific subreddit). Empty array includes all URLs.
  - **Exclude patterns**: Filter out unwanted sources (applied after inclusion logic)
  - Patterns use substring matching for flexibility

- **Notifications**:
  - Webhook URL for real-time POST requests when matches are found
  - Email notifications to specified addresses

- **Rate Limiting**: Match quota based on subscription plan; monitors may be temporarily rate-limited when quota is reached

#### Keyword Matches

Results generated when keywords are detected:

- **Match Data**:
  - Matched keyword and source text content
  - Platform (Reddit or X) and source URL
  - Timestamp of match discovery
  - Parent text contents (experimental): conversation thread context for replies

- **Optional Fields**:
  - Relevance/quality score (0-100)
  - Analysis or notes about the match

- **Lifecycle Management**:
  - Automatic archiving after plan-defined period
  - Automatic deletion of archived matches (default: 30 days after archiving)
  - Manual archive/unarchive via API

### 4. AI Content Generation

AI-powered content creation capabilities to streamline engagement and analysis workflows.

**Current Capabilities:**

- **Reply Generation for Keyword Matches**: Automatically generate contextually relevant replies to keyword matches found across social media platforms. Uses match content, conversation context, and your organization's profile to craft appropriate responses.

- **Company Analysis from URL**: Generate comprehensive business intelligence reports from any company website (see Company Data section above). Produces structured analysis including company summary, products/services, target customers, value proposition, competitors, and industry insights.

**Coming Soon:**

- Tweet generation
- Reddit post creation
- Blog post writing
- Additional content formats

**Rate Limiting**: AI generation features are subject to plan-based quotas to manage usage and costs.

## Organization Profile

Manage your organization's settings:

- Organization name and website URL
- Internal overview (markdown format)
- Custom keyword match scoring instructions for tailored relevance scoring

## Use Cases

1. **Brand Monitoring**: Track real-time mentions of your company or products across social platforms
2. **Competitor Intelligence**: Monitor competitor mentions, customer feedback, and market positioning
3. **Market Research**: Track industry trends, keywords, and sentiment across target communities
4. **Customer Discovery**: Identify individuals and companies discussing problems your product addresses
5. **Lead Generation**: Find potential customers expressing relevant needs or pain points in real-time
6. **Enrichment**: Augment existing records with comprehensive company and people data
7. **Prospecting**: Search for companies and decision-makers matching your ideal customer profile

## Technical Overview

**API Format**: RESTful API with JSON request/response bodies
**API Version**: v2
**Authentication**: API key-based (details in API documentation)
**Pagination**: Cursor-based pagination using `starting_after` and `starting_before` parameters
**Rate Limiting**: Plan-based limits on AI analysis, keyword matches, and certain real-time features