orangeslice 1.7.0 → 1.7.1

package/dist/apify.js

@@ -5,8 +5,9 @@ exports.run = run;
 exports.search = search;
 exports.getInputSchema = getInputSchema;
 const queue_1 = require("./queue");
-const API_URL = process.env.ORANGESLICE_API_URL?.replace(/\?.*/, "") + "?functionId=apify" ||
-    "https://orangeslice.ai/api/function?functionId=apify";
+const API_URL = process.env.ORANGESLICE_API_URL
+    ? process.env.ORANGESLICE_API_URL.replace(/\?.*/, "") + "?functionId=apify"
+    : "https://orangeslice.ai/api/function?functionId=apify";
 // Rate limit: 2 concurrent, 500ms between requests (Apify runs can be expensive)
 const queue = (0, queue_1.createQueue)(2);
 const rateLimiter = (0, queue_1.createRateLimiter)(500);

package/dist/generateObject.js

@@ -4,8 +4,9 @@ exports.generateObject = void 0;
 exports.generate = generate;
 exports.extract = extract;
 const queue_1 = require("./queue");
-const API_URL = process.env.ORANGESLICE_API_URL?.replace(/\?.*/, "") + "?functionId=generateObject"
-    || "https://orangeslice.ai/api/function?functionId=generateObject";
+const API_URL = process.env.ORANGESLICE_API_URL
+    ? process.env.ORANGESLICE_API_URL.replace(/\?.*/, "") + "?functionId=generateObject"
+    : "https://orangeslice.ai/api/function?functionId=generateObject";
 // Rate limit: 2 concurrent, 200ms between requests
 const queue = (0, queue_1.createQueue)(2);
 const rateLimiter = (0, queue_1.createRateLimiter)(200);

package/dist/geo.js

@@ -5,8 +5,9 @@ exports.parseAddress = parseAddress;
 exports.geocode = geocode;
 exports.getCityState = getCityState;
 const queue_1 = require("./queue");
-const API_URL = process.env.ORANGESLICE_API_URL?.replace(/\?.*/, "") + "?functionId=geo"
-    || "https://orangeslice.ai/api/function?functionId=geo";
+const API_URL = process.env.ORANGESLICE_API_URL
+    ? process.env.ORANGESLICE_API_URL.replace(/\?.*/, "") + "?functionId=geo"
+    : "https://orangeslice.ai/api/function?functionId=geo";
 // Rate limit: 2 concurrent, 100ms between requests
 const queue = (0, queue_1.createQueue)(2);
 const rateLimiter = (0, queue_1.createRateLimiter)(100);

package/docs/b2b-docs/B2B_CROSS_TABLE_TEST_FINDINGS.md

@@ -0,0 +1,255 @@
+# B2B Cross-Table Query Test Findings
+
+Comprehensive performance comparison between normalized tables (`linkedin_profile`, `linkedin_company`) and denormalized views (`lkd_profile`, `lkd_company`) for cross-table queries.
+
+---
+
+## Executive Summary
+
+| Pattern                            | Normalized | Denormalized | Winner       | Speedup |
+| ---------------------------------- | ---------- | ------------ | ------------ | ------- |
+| **Company ID lookup → employees**  | 48ms       | 279ms        | Normalized   | 5.8x    |
+| **Company name (org) search**      | 274ms      | 8,600ms      | Normalized   | 31x     |
+| **GIN-indexed org ILIKE**          | 430ms      | 29,409ms     | Normalized   | 68x     |
+| **Title ILIKE (common term)**      | 64ms       | 313ms        | Normalized   | 4.9x    |
+| **updated_at filter**              | 4ms        | 14ms         | Normalized   | 3.5x    |
+| **Company ID direct lookup**       | 4ms        | 31ms         | Normalized   | 7.8x    |
+| **Headline (rare term)**           | 2,530ms    | 1,258ms      | Denormalized | 2x      |
+| **Skill array search**             | 216ms      | 169ms        | Denormalized | 1.3x    |
+| **Industry + employee_count**      | 742ms      | 202ms        | Denormalized | 3.7x    |
+| **Headline + company size (JOIN)** | 20,205ms   | 217ms        | Denormalized | 93x     |
+| **Multi-skill + company size**     | 28,173ms   | 1,281ms      | Denormalized | 22x     |
+| **Skill + company industry**       | TIMEOUT    | 3,553ms      | Denormalized | ∞       |
+| **Complex multi-filter + company** | TIMEOUT    | 4,947ms      | Denormalized | ∞       |
+| **AI company + SF location**       | TIMEOUT    | 11,061ms     | Denormalized | ∞       |
+
+**Key Finding**: When combining profile text filters (headline, skills) with company constraints (employee_count, industry), **denormalized JOINs are 20-90x faster** and often the only option that completes within timeout.
+
+---
+
+## Critical Pattern: Profile + Company Combined Filters
+
+The most important discovery: **cross-table queries with text filters perform dramatically better with denormalized tables**.
+
+### Normalized Multi-JOIN (Often Fails)
+
+```sql
+-- ❌ TIMEOUT or 20+ seconds
+SELECT lp.id, lp.first_name, lp.headline, lc.company_name
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+JOIN linkedin_company lc ON lc.id = pos.linkedin_company_id
+WHERE pos.end_date IS NULL
+  AND lp.headline ILIKE '%engineer%'
+  AND lc.employee_count > 1000
+LIMIT 50
+-- Result: 20,205ms
+```
+
+### Denormalized JOIN (Fast)
+
+```sql
+-- ✅ 217ms - 93x faster
+SELECT lkd.profile_id, lkd.first_name, lkd.headline, lkdc.name
+FROM lkd_profile lkd
+JOIN lkd_company lkdc ON lkdc.linkedin_company_id = lkd.linkedin_company_id
+WHERE lkd.headline ILIKE '%engineer%'
+  AND lkdc.employee_count > 1000
+LIMIT 50
+-- Result: 217ms
+```
+
+---
+
+## Test Results by Category
+
+### A. Company-First Queries
+
+| Test | Query                           | Normalized | Denormalized | Winner            |
+| ---- | ------------------------------- | ---------- | ------------ | ----------------- |
+| A1   | Employees at company ID         | **48ms**   | 279ms        | Normalized (5.8x) |
+| A2   | Employees by company name (org) | **274ms**  | 8,600ms      | Normalized (31x)  |
+| A3   | Engineers at large companies    | **96ms**   | 234ms        | Normalized (2.4x) |
+
+**Conclusion**: For company-first queries, normalized tables win due to indexed lookups.
+
+### B. Profile-First Queries
+
+| Test | Query                      | Normalized | Denormalized | Winner              |
+| ---- | -------------------------- | ---------- | ------------ | ------------------- |
+| B1   | Python developers          | 216ms      | **169ms**    | Denormalized (1.3x) |
+| B2   | US Data Scientists         | 644ms      | **557ms**    | Denormalized (1.2x) |
+| B3   | Senior engineers + company | 4,535ms    | **196ms**    | Denormalized (23x)  |
+
+**Conclusion**: Simple profile queries are similar; profile + company queries favor denormalized.
+
+### C. Complex Prospecting Queries
+
+| Test | Query                                     | Normalized  | Denormalized | Winner            |
+| ---- | ----------------------------------------- | ----------- | ------------ | ----------------- |
+| C1   | Decision makers at funded startups        | **1,198ms** | 3,124ms      | Normalized (2.6x) |
+| C2   | AI company employees in SF                | TIMEOUT     | **11,061ms** | Denormalized (∞)  |
+| C3   | Hybrid (normalized profile + lkd_company) | 9,631ms     | -            | -                 |
+
+**Conclusion**: When funding table is used (indexed JOIN), normalized wins. When text filters span tables, denormalized wins.
+
+### D. Company Lookups
+
+| Test | Query                      | Normalized | Denormalized | Winner              |
+| ---- | -------------------------- | ---------- | ------------ | ------------------- |
+| D1   | Company by ID              | **4ms**    | 31ms         | Normalized (7.8x)   |
+| D2   | Industry + employee filter | 742ms      | **202ms**    | Denormalized (3.7x) |
+
+### E. Edge Cases
+
+| Test | Query                 | Normalized | Denormalized | Winner              |
+| ---- | --------------------- | ---------- | ------------ | ------------------- |
+| E1   | Headline (blockchain) | 713ms      | **384ms**    | Denormalized (1.9x) |
+| E2   | Company description   | 144ms      | 152ms        | Tie                 |
+
+### F. Verification Tests
+
+| Test | Query                        | Normalized | Denormalized | Winner              |
+| ---- | ---------------------------- | ---------- | ------------ | ------------------- |
+| F1   | Multi-skill + company size   | 28,173ms   | **1,281ms**  | Denormalized (22x)  |
+| F2   | Country + org (GIN)          | **990ms**  | 4,594ms      | Normalized (4.6x)   |
+| F3   | Title regex + company filter | 434ms      | **227ms**    | Denormalized (1.9x) |
+
+### G. Index Pattern Tests
+
+| Test | Query                     | Normalized | Denormalized | Winner            |
+| ---- | ------------------------- | ---------- | ------------ | ----------------- |
+| G1   | org ILIKE (GIN indexed)   | **430ms**  | 29,409ms     | Normalized (68x)  |
+| G2   | headline ILIKE (no index) | 2,530ms    | **1,258ms**  | Denormalized (2x) |
+| G3   | title ILIKE               | **64ms**   | 313ms        | Normalized (4.9x) |
+| G4   | updated_at filter         | **4ms**    | 14ms         | Normalized (3.5x) |
+
+### H. Cross-Table JOIN Patterns
+
+| Test | Query                     | Normalized | Denormalized | Winner             |
+| ---- | ------------------------- | ---------- | ------------ | ------------------ |
+| H1   | Headline + employee_count | 20,205ms   | **217ms**    | Denormalized (93x) |
+| H2   | Skill + company industry  | TIMEOUT    | **3,553ms**  | Denormalized (∞)   |
+| H3   | Multi-filter + company    | TIMEOUT    | **4,947ms**  | Denormalized (∞)   |
+
+---
+
+## Decision Rules for Cross-Table Queries
+
+### Use Normalized (`linkedin_profile` + `linkedin_company` JOINs) When:
+
+1. **Company-first lookup** - Start with company ID, get employees
+2. **GIN-indexed field** - Searching `linkedin_profile.org` (company name)
+3. **Indexed lookups** - `updated_at`, company ID, profile ID
+4. **Title field search** - `linkedin_profile.title` is faster
+5. **Indexed JOIN tables** - `linkedin_crunchbase_funding`, `linkedin_profile_position3` by company
+
+### Use Denormalized (`lkd_profile` JOIN `lkd_company`) When:
+
+1. **Headline + company filter** - 93x faster
+2. **Skill + company constraint** - Normalized times out
+3. **Multi-filter combinations** - 22x faster
+4. **Industry + employee_count** - 3.7x faster
+5. **Text filter spanning profile + company** - Often only option
+
+### Never Use:
+
+1. `lkd_profile.company_name` ILIKE - Use `linkedin_profile.org` (68x faster)
+2. Normalized multi-JOIN with headline filter - Will timeout or be 20s+
+
+---
+
+## Recommended Query Patterns
+
+### Pattern 1: Find Employees at Company by Name
+
+```sql
+-- ✅ BEST: Use GIN-indexed org field
+SELECT id, first_name, title, headline, org
+FROM linkedin_profile
+WHERE org ILIKE '%Google%'
+LIMIT 50
+-- Result: 274ms
+```
+
+### Pattern 2: Find Engineers at Large Companies
+
+```sql
+-- ✅ BEST: Denormalized JOIN (93x faster)
+SELECT lkd.profile_id, lkd.first_name, lkd.headline, lkdc.name, lkdc.employee_count
+FROM lkd_profile lkd
+JOIN lkd_company lkdc ON lkdc.linkedin_company_id = lkd.linkedin_company_id
+WHERE lkd.headline ILIKE '%engineer%'
+  AND lkdc.employee_count > 1000
+LIMIT 50
+-- Result: 217ms
+```
+
+### Pattern 3: Find People with Skills at Specific Company Types
+
+```sql
+-- ✅ BEST: Denormalized (normalized times out)
+SELECT lkd.profile_id, lkd.first_name, lkd.headline, lkdc.name
+FROM lkd_profile lkd
+JOIN lkd_company lkdc ON lkdc.linkedin_company_id = lkd.linkedin_company_id
+WHERE 'Python' = ANY(lkd.skills)
+  AND 'SQL' = ANY(lkd.skills)
+  AND lkdc.employee_count BETWEEN 100 AND 5000
+LIMIT 50
+-- Result: 1,281ms (normalized: 28,173ms)
+```
+
+### Pattern 4: Prospecting Query (Profile Criteria + Company Criteria)
+
+```sql
+-- ✅ BEST: Denormalized for multi-filter
+SELECT lkd.profile_id, lkd.first_name, lkd.title, lkdc.name, lkdc.employee_count
+FROM lkd_profile lkd
+JOIN lkd_company lkdc ON lkdc.linkedin_company_id = lkd.linkedin_company_id
+WHERE lkd.title ~* '(manager|director|lead)'
+  AND lkdc.employee_count BETWEEN 100 AND 1000
+LIMIT 50
+-- Result: 227ms (normalized: 434ms)
+```
+
+### Pattern 5: Decision Makers at Funded Startups
+
+```sql
+-- ✅ BEST: Normalized when using indexed funding table
+SELECT DISTINCT lp.id, lp.first_name, lp.title, lc.company_name
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+JOIN linkedin_company lc ON lc.id = pos.linkedin_company_id
+JOIN linkedin_crunchbase_funding cf ON cf.linkedin_company_id = lc.id
+WHERE pos.end_date IS NULL
+  AND lp.title ~* '(CEO|CTO|VP|Director|Head)'
+  AND lc.employee_count BETWEEN 10 AND 500
+LIMIT 50
+-- Result: 1,198ms
+```
+
+---
+
+## Summary: The Cross-Table Golden Rules
+
+1. **Company name search** → Always use `linkedin_profile.org` (GIN indexed, 68x faster)
+2. **Headline/skill + company constraint** → Always use denormalized JOIN (20-93x faster, normalized often times out)
+3. **Company-first lookups** → Use normalized (5-8x faster)
+4. **Indexed table JOINs (funding, positions)** → Normalized is fine
+5. **Multi-filter profile + company** → Denormalized is the only option that works
+
+### Quick Decision:
+
+```
+Need to search by company name?
+  └─ YES → Use linkedin_profile.org
+
+Need profile text filter (headline/skills) + company constraint?
+  └─ YES → Use lkd_profile JOIN lkd_company
+
+Need company ID lookup or indexed JOIN?
+  └─ YES → Use normalized tables
+
+Default for prospecting queries:
+  └─ Use lkd_profile JOIN lkd_company
+```

package/docs/b2b-docs/B2B_DATABASE.md

@@ -0,0 +1,314 @@
+# B2B Database Guide
+
+A comprehensive B2B data enrichment database with LinkedIn profiles, companies, job postings, and funding data.
+
+## Database Scale
+
+| Table                         | Estimated Rows   |
+| ----------------------------- | ---------------- |
+| `linkedin_profile`            | **1.15 billion** |
+| `linkedin_profile_position3`  | **2.6 billion**  |
+| `linkedin_job`                | **1.48 billion** |
+| `linkedin_profile_education2` | **965 million**  |
+| `linkedin_profile_slug`       | **1.14 billion** |
+| `person`                      | **1.32 billion** |
+
+---
+
+## Access Permissions
+
+### ✅ Tables WITH Access (48 tables)
+
+| Category            | Tables                                                                                                                                                                                                                                       |
+| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Core LinkedIn**   | `linkedin_profile`, `linkedin_company`, `linkedin_job`, `linkedin_profile_position3`, `linkedin_profile_education2`                                                                                                                          |
+| **Slugs**           | `linkedin_profile_slug`, `linkedin_company_slug`                                                                                                                                                                                             |
+| **Funding**         | `linkedin_crunchbase_funding`                                                                                                                                                                                                                |
+| **Reference**       | `linkedin_industry`, `linkedin_school`, `linkedin_language`, `linkedin_specialty`, `linkedin_work_modality`                                                                                                                                  |
+| **Profile Details** | `linkedin_profile_certification`, `linkedin_profile_award`, `linkedin_profile_project`, `linkedin_profile_volunteer_experience`, `linkedin_profile_recommendation2`, `linkedin_profile_test_scores`, `linkedin_profile_language_proficiency` |
+| **Company Details** | `linkedin_company_address2`, `linkedin_company_post`                                                                                                                                                                                         |
+| **Content**         | `linkedin_article`, `linkedin_patent`, `linkedin_project`, `linkedin_publication2`                                                                                                                                                           |
+| **Jobs**            | `job_title`, `job_function`, `job_seniority`, `job_employment_type`, `job_academic_qualification`                                                                                                                                            |
+| **Geography**       | `country`, `locality`, `naics_code`                                                                                                                                                                                                          |
+| **Other**           | `company`, `company_type`, `person`, `language_proficiency`                                                                                                                                                                                  |
+
+### ❌ Tables WITHOUT Access (84 tables)
+
+| Category              | Tables (Permission Denied)                                        |
+| --------------------- | ----------------------------------------------------------------- |
+| **Contact Data**      | `email_address`, `email_address_linkedin_profile`, `phone_number` |
+| **Company Reference** | `company_size`, `company_location`, `company_country`             |
+| **Geography**         | `linkedin_geo`                                                    |
+| **Indeed**            | All `indeed_*` tables                                             |
+| **Domain/Web**        | `domain`, `host`, `domain_traffic_estimate`, `web_tag`            |
+| **App Store**         | `ios_sdk`, `play_store_sdk`, `itunes_*`, `play_store_*`           |
+
+---
+
+## Top Industries
+
+| ID  | Industry                             | Companies |
+| --- | ------------------------------------ | --------- |
+| 48  | Construction                         | 1.96M     |
+| 44  | Real Estate                          | 1.80M     |
+| 96  | IT Services and IT Consulting        | 1.79M     |
+| 27  | Retail                               | 1.51M     |
+| 80  | Advertising Services                 | 1.33M     |
+| 11  | Business Consulting and Services     | 1.32M     |
+| 4   | **Software Development**             | 1.19M     |
+| 6   | Technology, Information and Internet | 617K      |
+
+---
+
+## GTM Query Examples
+
+### 🏢 Company Enrichment
+
+**Find company by universal_name (FAST ~300ms)**
+
+```sql
+SELECT id, company_name, domain, website, employee_count,
+       locality, country_code, description
+FROM linkedin_company
+WHERE universal_name = 'stripe';
+```
+
+**Find company by domain (FAST ~500ms)**
+
+```sql
+SELECT id, company_name, universal_name, employee_count, locality
+FROM linkedin_company
+WHERE domain = 'openai.com';
+```
+
+**Full company enrichment with industry**
+
+```sql
+SELECT lc.company_name, lc.domain, lc.employee_count, lc.locality,
+       lc.description, li.name as industry_name
+FROM linkedin_company lc
+LEFT JOIN linkedin_industry li ON li.id = lc.industry_code
+WHERE lc.universal_name = 'openai';
+```
+
+### 👤 Profile Lookup
+
+**Find profile by LinkedIn slug (FAST ~400ms - use key64)**
+
+```sql
+SELECT lp.first_name, lp.last_name, lp.headline, lp.location_name
+FROM linkedin_profile lp
+JOIN linkedin_profile_slug lps ON lps.linkedin_profile_id = lp.id
+WHERE lps.slug_key64 = key64('satyanadella');
+```
+
+**Find company by LinkedIn slug (FAST ~400ms - use key64)**
+
+```sql
+SELECT lc.id, lc.company_name, lc.domain, lc.employee_count
+FROM linkedin_company lc
+JOIN linkedin_company_slug lcs ON lcs.linkedin_company_id = lc.id
+WHERE lcs.slug_key64 = key64('meta');
+```
+
+### 👥 Find Employees at a Company
+
+**Current employees at a company**
+
+```sql
+SELECT lp.first_name, lp.last_name, lp.headline, pos.title
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+WHERE pos.linkedin_company_id = 2135371  -- Stripe's ID
+  AND pos.end_date IS NULL
+LIMIT 100;
+```
+
+**Headcount by role at a company**
+
+```sql
+SELECT pos.title, COUNT(*) as count
+FROM linkedin_profile_position3 pos
+WHERE pos.linkedin_company_id = 11130470  -- OpenAI
+  AND pos.end_date IS NULL
+GROUP BY pos.title
+ORDER BY count DESC
+LIMIT 20;
+```
+
+### 🎯 Find Decision Makers
+
+**VPs of Sales at mid-to-large companies**
+
+```sql
+SELECT lp.first_name, lp.last_name, lp.headline,
+       pos.title, lc.company_name, lc.employee_count
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+JOIN linkedin_company lc ON lc.id = pos.linkedin_company_id
+WHERE pos.title ILIKE '%vp%sales%'
+  AND pos.end_date IS NULL
+  AND lc.employee_count > 50
+LIMIT 20;
+```
+
+**C-suite at mid-size software companies (~10 seconds)**
+
+```sql
+SELECT lp.first_name, lp.last_name, pos.title,
+       lc.company_name, lc.employee_count
+FROM linkedin_profile lp
+JOIN linkedin_profile_position3 pos ON pos.linkedin_profile_id = lp.id
+JOIN linkedin_company lc ON lc.id = pos.linkedin_company_id
+WHERE pos.end_date IS NULL
+  AND lc.employee_count BETWEEN 100 AND 500
+  AND lc.industry_code = 4  -- Software Development
+  AND (pos.title ILIKE 'ceo%' OR pos.title ILIKE 'cto%'
+       OR pos.title ILIKE 'cfo%' OR pos.title ILIKE 'chief%')
+LIMIT 20;
+```
+
+### 🔍 Find People by Skills
+
+```sql
+SELECT lp.first_name, lp.last_name, lp.headline,
+       lp.skills[1:5] as top_skills, lp.location_name
+FROM linkedin_profile lp
+WHERE 'Python' = ANY(lp.skills)
+  AND 'Machine Learning' = ANY(lp.skills)
+LIMIT 20;
+```
+
+### 🎓 Find Alumni
+
+```sql
+SELECT lp.first_name, lp.last_name, lp.headline,
+       edu.school_name, edu.degree
+FROM linkedin_profile lp
+JOIN linkedin_profile_education2 edu ON edu.linkedin_profile_id = lp.id
+WHERE edu.school_name ILIKE '%stanford%'
+LIMIT 20;
+```
+
+### 📍 Find People by Location
+
+```sql
+SELECT lp.first_name, lp.last_name, lp.headline, lp.location_name
+FROM linkedin_profile lp
+WHERE lp.location_name ILIKE '%san francisco%'
+LIMIT 20;
+```
+
+### 💼 Job Postings
+
+**Recent jobs at a company with salary info**
+
+```sql
+SELECT lj.title, lj.location, lj.salary_range,
+       lj.salary_min, lj.salary_max, lj.posted_date, lj.applicants
+FROM linkedin_job lj
+WHERE lj.linkedin_company_id = 2135371  -- Stripe
+ORDER BY lj.posted_date DESC NULLS LAST
+LIMIT 20;
+```
+
+### 💰 Companies with Funding
+
+```sql
+SELECT lc.company_name, lc.domain, lc.employee_count,
+       cf.round_name, cf.round_date, cf.round_amount,
+       cf.investor_names[1:3] as top_investors
+FROM linkedin_company lc
+JOIN linkedin_crunchbase_funding cf ON cf.linkedin_company_id = lc.id
+WHERE cf.round_date >= '2024-01-01'
+ORDER BY cf.round_date DESC
+LIMIT 20;
+```
+
+---
+
+## Performance Guide
+
+### ✅ Fast Queries (indexed lookups)
+
+| Lookup Method                      | Speed  | Example                            |
+| ---------------------------------- | ------ | ---------------------------------- |
+| Company by `universal_name`        | ~300ms | `WHERE universal_name = 'stripe'`  |
+| Company by `domain`                | ~500ms | `WHERE domain = 'stripe.com'`      |
+| Company by `id`                    | ~300ms | `WHERE id = 2135371`               |
+| Profile/Company by `slug_key64`    | ~400ms | `WHERE slug_key64 = key64('meta')` |
+| Positions by `linkedin_company_id` | ~500ms | `WHERE linkedin_company_id = X`    |
+| Positions by `linkedin_profile_id` | ~500ms | `WHERE linkedin_profile_id = X`    |
+| Jobs by `linkedin_company_id`      | ~1s    | `WHERE linkedin_company_id = X`    |
+| Education by `linkedin_profile_id` | ~500ms | `WHERE linkedin_profile_id = X`    |
+
+### ⚠️ Slow Queries (full table scans)
+
+| Query Type                          | Speed     | Reason                   |
+| ----------------------------------- | --------- | ------------------------ |
+| Company by `company_name ILIKE`     | Timeout   | No index on company_name |
+| Profile by `slug` (without key64)   | Timeout   | No index on raw slug     |
+| Profile by `headline ILIKE`         | Very slow | Full text scan           |
+| Aggregate queries across industries | 60s+      | Large table joins        |
+| Profile by `location_name ILIKE`    | Slow      | No index                 |
+
+### 🔑 Key Functions
+
+```sql
+-- Convert slug to indexed key64 for fast lookups
+key64('stripe')  -- Returns bigint for index lookup
+
+-- Example: Fast profile lookup
+WHERE slug_key64 = key64('satyanadella')
+
+-- Example: Fast company lookup
+WHERE slug_key64 = key64('meta')
+```
+
+---
+
+## Common Gotchas
+
+1. **Use `company_name` not `name`** - The column is `company_name` on linkedin_company
+2. **Use `slug_key64` for slug lookups** - Raw `slug` column is not indexed
+3. **Use `linkedin_profile_position3`** - position2 is legacy
+4. **Use `industry_code`** - Not `linkedin_industry_id` on linkedin_company
+5. **NULL `end_date` = current position** - Check for current employees
+6. **Email/phone tables are restricted** - Cannot access contact data directly
+7. **Always use LIMIT** - Tables are massive
+8. **Use `ILIKE` for case-insensitive** - Names vary in casing
+
+---
+
+## Schema Exploration
+
+```sql
+-- List accessible tables
+SELECT table_name
+FROM information_schema.table_privileges
+WHERE grantee = 'jzt2be9botwq' AND privilege_type = 'SELECT'
+ORDER BY table_name;
+
+-- Describe a table
+SELECT column_name, data_type, is_nullable
+FROM information_schema.columns
+WHERE table_name = 'linkedin_profile';
+
+-- Check table indexes
+SELECT indexname, indexdef
+FROM pg_indexes
+WHERE tablename = 'linkedin_company';
+
+-- Check table row counts
+SELECT relname AS table_name, reltuples::bigint AS estimated_rows
+FROM pg_class
+WHERE relkind = 'r' AND relnamespace = 'public'::regnamespace
+ORDER BY reltuples DESC
+LIMIT 25;
+```
+
+---
+
+## Related Documentation
+
+- **[B2B_SCHEMA.md](./B2B_SCHEMA.md)** - Complete schema reference with all columns and indexes