Documentation Index
Fetch the complete documentation index at: https://support.affinity.co/llms.txt
Use this file to discover all available pages before exploring further.
Concept — background and overview.
Key Concepts and How It Works
What is Semantic Search?
Traditional keyword search (current default):- Matches exact words you type
- For companies: Only searches name and website URL
- Requires you to know exactly what you’re looking for
- Example: “Stripe” finds Stripe, but “payment processing company” finds nothing
- Understands the meaning and context of your query
- Searches across company attributes like industry, location, interactions, and relationships
- Recognizes concepts, synonyms, and business context
- Works with natural language descriptions
- Example: “payment processing companies” finds Stripe, Square, and other relevant companies
How Semantic Search Works
When you enter a natural language query:- AI analyzes your query to understand what you’re asking for:
- Attributes mentioned (industry, location, investors)
- Context clues (“my firm met with”, “in our pipeline”, “in our network”)
- Time references (“last week”, “recently”, “this quarter”)
- Business concepts (“healthcare”, “AI companies”, “solar energy”)
- Searches across available company data including:
- Affinity Data: Industry, description, location, investor information
- Smart Attributes (firm-wide): First/Last Contact, First/Last Meeting, First/Last Email, Next Meeting
- Relationship Intelligence (firm-wide): Interaction history (meetings, emails), relationship scores
- CRM Context: Org-relevant status (companies in your firm’s CRM)
- Ranks results by relevance:
- Prioritizes org-relevant companies (companies your firm knows) over universal dataset
- Considers how well each company matches your query
- Shows most relevant results first
- Returns results typically within 10 seconds with:
- Matching companies
- Explanation of how results were found
- Ability to refine your query if results don’t match expectations
- Interaction dates reflect ANY team member’s interactions
- Relationship scores are firm-wide maximum
- “I” and “we” in queries mean “my firm”
- You cannot search for “companies only I personally contacted”
What Data is Searchable
For Companies (January 2026): Affinity Data:- Name and domain
- Description
- Industry
- Headquarters location
- Investor information (investors who have funded the company)
- First/Last Contact with your firm
- First/Last Meeting with your firm
- First/Last Email with your firm
- Next Meeting scheduled with your firm
- Interaction history (meetings and emails between company and your firm)
- Relationship scores (firm-wide max relationship strength)
- Org-relevant status (companies your firm has interacted with or added to Affinity)
- Note: “In our pipeline” searches org-relevant companies, NOT specific list membership
When to Use Semantic Search vs. Keyword Search
Use Semantic Search When:
You know characteristics but not the name:- “Solar energy companies in our pipeline”
- “Healthcare companies in Boston”
- “Companies in the payments space”
- “Healthcare company my firm met with last week”
- “Companies we haven’t contacted in 90 days”
- “Companies our firm had meetings with this quarter”
- “Companies backed by Sequoia Capital”
- “Companies backed by both Andreessen Horowitz and Sequoia”
- “Early stage companies with low relationship scores”
- “Companies where we have strong connections”
- “Companies with no recent contact”
- “AI companies in San Francisco”
- “Solar energy companies that use battery storage technology”
- “Healthcare companies focused on cancer diagnosis”
- “That biotech company someone at our firm talked to at the conference”
- “The solar company mentioned in our partner meeting”
Use Keyword Search When:
You know the exact name:- “Stripe” (instant results)
- “OpenAI” (direct match)
- “stripe.com”
- “openai.com”
- Keyword search is faster (less than 1 second vs ~10 seconds)
- Better for quick lookups when you know what you’re searching for
Example Queries
Supported Company Search Examples (January 2026)
By Industry and Location:- “Healthcare companies in our network”
- “Fintech startups in San Francisco”
- “Climate tech companies in Boston”
- “Enterprise SaaS companies in New York”
- “AI companies focused on healthcare”
- “Companies backed by Sequoia Capital”
- “Companies backed by both Bain Capital and Bessemer”
- “Portfolio companies of Andreessen Horowitz”
- “Solar energy company my firm met with last week”
- “Companies we haven’t contacted in 90 days”
- “Healthcare companies our firm had meetings with this quarter”
- “Companies we emailed recently”
- “Early stage companies with low relationship scores”
- “Companies where we have strong connections”
- “Companies with weak relationships”
- “Payment processing companies”
- “AI companies focused on enterprise automation”
- “Solar energy companies using battery storage technology”
- “Healthcare companies focused on cancer diagnosis using AI”
- “Biotech companies working on extracellular vesicles”
How to Access and Use
Enabling Search with AI
- Navigate to Settings > Labs
- Find “Search with AI” feature
- Toggle ON
- Return to global search
Using Search with AI
- Open global search (Cmd+Option+K or Alt+K)
- Click “Search with AI” button
- Type your natural language query
- Press Enter
- Review results (appears in ~10 seconds)
- Click any company to view profile
- Edit query and re-run if needed
- Example queries are shown in the search interface
- Click an example to pre-fill your search bar
- Query stays visible for easy editing and refinement
Best Practices
Writing Effective Queries
Be specific:- “Companies” (too broad)
- “Healthcare companies in Boston” (specific attributes)
- “Show me AI companies our firm met with recently”
- “Find payment processing companies”
- “Which healthcare companies are in our network?”
- “Healthcare companies in Boston our firm met with this quarter”
- “AI companies backed by Sequoia that we haven’t contacted”
- “Last week”, “recently”, “in the past 6 months”
- “This quarter”, “this year”
- “Haven’t contacted in 90 days”
- “In our network” (org-relevant companies)
- “In our pipeline” (org-relevant companies)
- “Our firm met with”, “We haven’t contacted”
- Instead of just “healthcare”, try “healthcare companies focused on cancer diagnosis”
- Instead of “AI”, try “AI companies building enterprise automation tools”
- Instead of “energy”, try “solar energy companies using battery storage”
- “Companies I met with” searches your FIRM’s meetings, not just yours personally
- “I haven’t contacted” searches your FIRM’s contact history
Technical Notes
Performance:- Results typically return within 10 seconds
- May take longer for very complex queries
- Keyword search remains faster (less than 1 second) for simple name lookups
- Newly created companies searchable within ~10 seconds
- Updates to company data available in search within ~10 seconds
- Interaction data (meetings, emails) syncs continuously
- Semantic search respects same permissions as keyword search
- You only see companies you have permission to view
- Interaction history is firm-wide (not individual-specific)
- Relationship scores are firm-wide max relationship strength
- Returns most relevant results (typically 10-20 companies)
- Can refine query for different results
- For comprehensive analysis, use Lists filters instead
Frequently Asked Questions
How is this different from regular search? Regular keyword search only matches exact company names and URLs. Semantic search understands what you’re describing and searches across industry, location, investors, and firm interaction data. Do I need to use special syntax? No. Write queries like you’re asking a colleague: “Show me healthcare companies in Boston” or “Find companies backed by Sequoia.” The AI understands natural language. Does this replace keyword search? No. Keyword search remains the default and is still best for quick name lookups. Semantic search is an optional enhancement for contextual discovery. How long do results take? Semantic search typically returns results within 10 seconds (vs less than 1 second for keyword search). The AI needs time to understand your query and search across data. Does semantic search use my personal interaction history or firm-wide data? Semantic search uses FIRM-WIDE interaction data only. When you search for “companies I met with last week,” the AI searches for companies YOUR FIRM met with, not just your personal meetings. How do I know which mode I’m using? You’ll see “Search with AI” in the global search interface. You must enable it in Settings > Labs first. Keyword search remains the default. How are search results ordered, and how can I prioritize companies my firm knows? Semantic search ranks results using multiple factors:- Semantic relevance score (primary): How well the company matches your query across all attributes
- Org-relevance (secondary): Companies your firm knows are prioritized but not guaranteed first
- Data completeness (tertiary): Companies with richer descriptions and data rank higher
- “in my network”
- “in our pipeline”
- “companies we know”
Related Articles
- Conducting Searches in Affinity (global search overview)
- How to Filter and Sort in New Lists (for precise, reusable queries)
- How to create and use saved views within a list (for persistent filtered views)
- Affinity Data (fields included in semantic search)