CooperLabs B2B API Reference & Schema Guide
Production documentation for our RapidAPI Hub and direct K3s edge endpoints. Every endpoint is backed by a background-warmed Redis cache cluster on Kubernetes and returns enriched sales intelligence, executive summary analytics, and ready-to-send outbound hooks.
Base URLs & Redis Cache Control
Requests can be routed either through the RapidAPI Hub Proxy (for managed billing, rate limiting, and team keys) or directly via our Cloudflare Zero Trust Kubernetes ingress. Every endpoint accepts an optional bypass_cache query parameter: when false (default), cached responses return in <25ms; when true, the engine performs a fresh live crawl and updates Redis.
RapidAPI Authentication Headers
Include your RapidAPI subscription key and host header on every request:
X-RapidAPI-Key: YOUR_RAPIDAPI_KEY X-RapidAPI-Host: cooperlabs-b2b-lead-municipal-permit-api.p.rapidapi.com Accept: application/json
GET /v1/enrich/domain
Crawls a target company domain (plus high-value internal subpages like /about, /contact, /pricing, /careers) concurrently with Cloudflare DNS-over-HTTPS (DoH) MX/SPF/DMARC inspection. Extracts departmental emails, email pattern templates, E.164 phones, social profiles, 50+ enterprise SaaS signatures, JSON-LD organization metadata, a deterministic 0–100 B2B Lead Score, and a personalized outbound sales icebreaker.
| Parameter | Type | Default | Description |
|---|---|---|---|
| domainREQUIRED | string | apify.com | Target company domain or URL (e.g., apify.com, cal.com, linear.app). |
| max_subpages | integer (0-8) | 3 | Maximum internal high-value contact/about/pricing/careers subpages to crawl concurrently. |
| bypass_cache | boolean | false | Set true to force a live multi-page crawl and DNS lookup instead of serving from Redis. |
curl --request GET \ --url 'https://cooperlabs-b2b-lead-municipal-permit-api.p.rapidapi.com/v1/enrich/domain?domain=apify.com&max_subpages=3' \ --header 'X-RapidAPI-Host: cooperlabs-b2b-lead-municipal-permit-api.p.rapidapi.com' \ --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY'
{
"status": "ok",
"cached": true,
"response_time_ms": 0.42,
"data": {
"domain": "apify.com",
"company_name": "Apify",
"meta_title": "Apify: Full-stack web scraping and data extraction platform",
"meta_description": "Cloud platform for web scraping, browser automation, and data for AI.",
"b2b_lead_score": 95,
"outbound_icebreaker": "Hi Apify team: noticed apify.com is running Google Tag Manager, HubSpot, Intercom (Google Workspace) with an opportunity around instant booking workflows.",
"contacts": {
"emails": ["[email protected]", "[email protected]", "[email protected]"],
"primary_email": "[email protected]",
"emails_by_department": {
"sales_and_inquiries": ["[email protected]"],
"support_and_success": ["[email protected]"],
"general": ["[email protected]"]
},
"inferred_email_patterns": [
"{first}.{last}@apify.com",
"{first}@apify.com",
"{f}{last}@apify.com"
],
"phones": ["(415) 555-0192"]
},
"social_links": {
"linkedin": "https://www.linkedin.com/company/apifytech",
"twitter_x": "https://x.com/apify",
"github": "https://github.com/apify",
"youtube": "https://www.youtube.com/@apify"
},
"dns_and_email_security": {
"has_mx_records": true,
"email_provider": "Google Workspace",
"has_spf": true,
"authorized_esp_senders_in_dns": ["Google Workspace", "SendGrid", "HubSpot Email"],
"has_dmarc": true,
"dmarc_policy": "reject"
},
"tech_stack_by_category": {
"analytics_and_telemetry": ["Google Tag Manager", "PostHog", "Segment"],
"crm_and_marketing": ["HubSpot", "Intercom"],
"frontend_and_cms": ["Next.js", "React"],
"ecommerce_and_payments": ["Stripe"],
"infrastructure_and_cdn": ["Cloudflare"]
},
"all_detected_technologies": [
"Cloudflare",
"Google Tag Manager",
"HubSpot",
"Intercom",
"Next.js",
"PostHog",
"React",
"Segment",
"Stripe"
],
"key_pages": {
"pricing_page_url": "https://apify.com/pricing",
"contact_page_url": "https://apify.com/contact",
"careers_page_url": "https://apify.com/jobs"
},
"crawl_metadata": {
"pages_crawled": 4,
"urls_visited": ["https://apify.com", "https://apify.com/about", "https://apify.com/contact", "https://apify.com/pricing"]
}
}
}
GET /v1/permits/search
Queries official municipal Socrata Open Data endpoints across 6 major US metropolitan jurisdictions (chicago, nyc, los_angeles, austin, san_francisco, seattle) or all 6 simultaneously (city=all_metros). Includes top-level summary_analytics, project scale tiers, estimated material/subcontractor spend (32% CSI benchmark), and ready-to-send contractor pitch hooks.
| Parameter | Type | Default | Description |
|---|---|---|---|
| city | string | all_metros | Jurisdiction code: all_metros, chicago, nyc, los_angeles, austin, san_francisco, or seattle. |
| record_type | string | all | Filter by municipal record type: all, building_permit, or code_violation. |
| trade_filter | string | all | Trade category (all, solar, roofing, hvac, electrical, plumbing, demolition, new_construction, remodeling, code_remediation). Alias: permit_type_filter. |
| min_estimated_cost | number | 25000 | Minimum reported construction project valuation in USD. Alias: min_cost. |
| max_items | integer (1-100) | 15 | Maximum permit leads to return. Alias: limit. |
| zip_code | string | "" | Optional 5-digit postal code filter. |
| bypass_cache | boolean | false | Set true to query live municipal Socrata endpoints directly. |
{
"status": "ok",
"cached": true,
"response_time_ms": 0.31,
"city": "all_metros",
"record_type": "all",
"trade_filter": "all",
"count": 15,
"summary_analytics": {
"total_permits_returned": 15,
"total_project_valuation_usd": 18500000.0,
"average_project_valuation_usd": 1233333.33,
"estimated_total_subcontractor_opportunity_usd": 5920000.0,
"permits_by_city": { "chicago": 3, "nyc": 3, "los_angeles": 3, "austin": 2, "san_francisco": 2, "seattle": 2 },
"permits_by_trade": { "new_construction": 8, "remodeling": 4, "electrical": 3 },
"named_contractors_count": 14,
"high_priority_leads_count": 12
},
"items": [
{
"permit_id": "101098421",
"city": "chicago",
"state": "IL",
"record_type": "building_permit",
"permit_type_description": "PERMIT - NEW CONSTRUCTION",
"status": "ISSUED",
"issued_date": "2026-10-25",
"trade_category": "new_construction",
"address": "1420 W FULTON ST, Chicago, IL 60607",
"zip_code": "60607",
"work_description": "ERECT 4-STORY COMMERCIAL MIXED-USE BUILDING WITH ROOFTOP SOLAR ARRAY",
"estimated_cost": 1650000.0,
"fee_paid": 12450.0,
"contractor_name": "APEX MIDWEST BUILDERS LLC",
"contractor_role": "GENERAL CONTRACTOR",
"owner_or_applicant": "FULTON MARKET REDEVELOPMENT GROUP LLC",
"latitude": 41.8867,
"longitude": -87.6624,
"b2b_lead_score": 98,
"project_scale_tier": "Mega Commercial ($1M+)",
"estimated_material_and_sub_spend_usd": 528000.0,
"outbound_pitch_hook": "Permit #101098421 issued on 2026-10-25 at 1420 W FULTON ST, Chicago, IL 60607 for new construction ($1,650,000 valuation; ~$528,000 estimated materials/sub-trade spend). Contact: APEX MIDWEST BUILDERS LLC."
}
]
}
GET /v1/jobs/search
Directly queries official JSON/GraphQL endpoints across Workday, Ashby, Greenhouse, and Lever. Normalizes compensation bands, seniority levels, role functions, 35+ technology keywords, and B2B hiring intent triggers with top-level summary_analytics.
| Parameter | Type | Default | Description |
|---|---|---|---|
| target | string | greenhouse:stripe,ashby:ramp,lever:palantir,workday:nvidia | Comma-separated ATS career URLs or ats:slug identifiers. |
| keyword_filter | string | "" | Optional role, department, or tech keyword filter (e.g., engineer, security, kubernetes). Alias: keyword. |
| location_filter | string | "" | Optional location substring filter (e.g., San Francisco, New York, Remote). |
| department_filter | string | "" | Optional department or team filter (e.g., Engineering, Sales). |
| remote_only | boolean | false | Set true to return only remote-eligible job postings. |
| max_jobs_per_company | integer (1-100) | 10 | Maximum normalized job postings to return per company target. Alias: limit. |
| bypass_cache | boolean | false | Set true to query live ATS APIs directly. |
{
"status": "ok",
"cached": true,
"response_time_ms": 0.33,
"targets_queried": 4,
"count": 20,
"summary_analytics": {
"total_jobs_extracted": 20,
"remote_jobs_count": 12,
"disclosed_salary_count": 9,
"jobs_by_ats_platform": { "greenhouse": 5, "lever": 5, "ashby": 5, "workday": 5 },
"jobs_by_seniority": { "Senior": 11, "Mid-Level": 6, "Executive": 3 },
"top_technologies_in_demand": ["aws", "docker", "kubernetes", "postgresql", "python", "terraform", "typescript"],
"active_b2b_hiring_triggers": [
"Cloud / DevOps Infrastructure Scaling: Pitch Observability & Cloud Security",
"AI / LLM Engineering Expansion: Pitch GPU Compute, Vector DBs & MLOps"
]
},
"items": [
{
"company": "Ramp",
"ats_platform": "ashby",
"job_id": "9c8b4f12-3b7e-4b0a-9f1a-8e2d1a0c5e11",
"title": "Senior Software Engineer, Backend Platform",
"department": "Engineering",
"location": "New York, NY (Hybrid)",
"is_remote": true,
"employment_type": "FullTime",
"seniority_level": "Senior",
"role_function": "Engineering & Software",
"published_at": "2026-10-20",
"salary_range": "$175,000 - $235,000 USD",
"tech_stack_mentioned": ["aws", "docker", "kafka", "kubernetes", "postgresql", "python", "terraform"],
"b2b_hiring_signal": "Cloud / DevOps Infrastructure Scaling: Pitch Observability & Cloud Security",
"outbound_hiring_pitch_hook": "Ramp is actively hiring a Senior Software Engineer, Backend Platform (New York, NY (Hybrid)) with aws, docker, kafka, kubernetes ($175,000 - $235,000 USD). Signal: Cloud / DevOps Infrastructure Scaling: Pitch Observability & Cloud Security.",
"job_url": "https://jobs.ashbyhq.com/ramp/9c8b4f12-3b7e-4b0a-9f1a-8e2d1a0c5e11",
"description_snippet": "Ramp is building the next-generation financial operations platform. We are looking for a Senior Backend Platform Engineer to scale our distributed event-driven services on AWS, Kubernetes, and PostgreSQL..."
}
]
}
GET /v1/legal/search
Extracts trial attorneys and law firm partners across SuperLawyers, FindLaw, and LawInfo, then crawls each law firm's website to enrich verified decision-maker emails, email pattern templates, notable trial verdicts in USD, practice tier classification, legal tech stack (Clio, LawPay, Filevine), and live-chat intake gaps.
| Parameter | Type | Default | Description |
|---|---|---|---|
| practice_area | string | personal_injury | Practice area (personal_injury, medical_malpractice, workers_compensation, family_law, criminal_defense, business_litigation, employment_labor, estate_planning). |
| state | string | illinois | Target US state or 2-letter code (e.g., illinois, california, texas, new-york). |
| city | string | chicago | Target city slug (e.g., chicago, los-angeles, houston, miami). Shorthand alias location=chicago-il is also supported. |
| enrich_firm_websites | boolean | true | Crawls each law firm's website to extract direct emails and 25+ LegalTech signatures. |
| max_items | integer (1-30) | 8 | Maximum enriched attorney & law firm leads to return. Alias: limit. |
| bypass_cache | boolean | false | Set true to force a live directory and firm crawl. |
{
"status": "ok",
"cached": true,
"response_time_ms": 0.02,
"practice_area": "personal_injury",
"city": "chicago",
"state": "illinois",
"count": 8,
"summary_analytics": {
"total_attorneys_enriched": 8,
"verified_emails_count": 6,
"pattern_email_coverage_count": 8,
"total_combined_verdicts_usd": 537000000.0,
"average_years_experience": 18.4,
"firms_missing_live_chat_count": 3,
"detected_legal_tech_breakdown": {
"wordpress": 7,
"google_tag_manager": 6,
"callrail": 4,
"intaker_or_smith_ai": 3
}
},
"items": [
{
"directory_source": "SuperLawyers",
"attorney_name": "Mark A. Brown",
"credentials": "Partner",
"firm_name": "Lane Brown, LLC",
"practice_area_searched": "Personal Injury",
"practice_areas_all": ["Personal Injury - General: Plaintiff", "Medical Malpractice: Plaintiff"],
"practice_focus_breakdown": {
"Personal Injury - General: Plaintiff": "75%",
"Medical Malpractice: Plaintiff": "25%"
},
"city": "Chicago",
"state": "IL",
"address": "230 W Monroe St, Suite 1900, Chicago, IL 60606",
"direct_phone": "312-815-5222",
"firm_website": "https://www.lanebrownlaw.com",
"firm_domain": "lanebrownlaw.com",
"verified_emails": ["[email protected]", "[email protected]"],
"primary_email": "[email protected]",
"inferred_email_patterns": ["[email protected]", "[email protected]"],
"superlawyers_Selection": "Selected to Super Lawyers: 2012 - 2026",
"years_licensed": 30,
"notable_verdicts_and_settlements": ["$3,600,000 Settlement - Construction Site Fall"],
"total_reported_verdicts_usd": 3600000.0,
"highest_reported_verdict_usd": 3600000.0,
"practice_tier": "Million-Dollar Trial Partner ($1M+ Verdicts)",
"legal_tech_stack": ["callrail", "google_tag_manager", "wordpress"],
"has_live_chat_or_intake_bot": false,
"b2b_lead_score": 100,
"outbound_icebreaker": "Hi Mark: saw your $3,600,000 reported case result and your selection to IL Super Lawyers at Lane Brown, LLC; noticed https://www.lanebrownlaw.com (no 24/7 legal live chat / ai intake widget detected)."
}
]
}
GET /v1/events/search
Extracts upcoming B2B trade shows, conferences, and verified conference speakers across 10times, Sessionize, Eventbrite, and Confs.tech, then crawls external conference and speaker websites to enrich verified organizer/speaker emails, email patterns, LinkedIn profiles, event tech stack (Cvent, Bizzabo, Eventbrite, Sessionize), and sponsorship outreach icebreakers.
| Parameter | Type | Default | Description |
|---|---|---|---|
| category | string | technology | Industry vertical: technology, business, finance, healthcare, legal, energy, manufacturing, marketing. |
| location | string | chicago-il | Target metro slug (e.g., chicago-il, new-york, san-francisco, austin, las-vegas). |
| mode | string | both | Extraction mode: both, conferences, or speakers. |
| limit | integer (1-40) | 10 | Maximum enriched conference & speaker records to return. |
{
"status": "ok",
"cached": true,
"response_time_ms": 0.35,
"category": "technology",
"location": "chicago-il",
"mode": "both",
"count": 8,
"summary_analytics": {
"total_records_enriched": 8,
"conferences_and_tradeshows_count": 4,
"verified_speakers_and_organizers_count": 4,
"verified_emails_count": 2,
"linkedin_profiles_count": 4,
"company_domains_resolved_count": 6,
"detected_event_tech_breakdown": { "Sessionize": 4, "Eventbrite": 2, "Cloudflare": 2 }
},
"items": [
{
"record_type": "conference_speaker_and_leader",
"source_directory": "Sessionize Speaker & Conference Directory",
"event_or_speaker_name": "Roberth Strand",
"headline_or_event_type": "Cloud Native Architect & Microsoft MVP",
"category": "technology",
"location": "Oslo, Norway / Global",
"events_spoken_count": 35,
"published_sessions_count": 18,
"company_or_organizer_domain": "robstr.dev",
"linkedin_url": "https://linkedin.com/in/roberthstrand",
"verified_emails": ["[email protected]"],
"inferred_email_patterns": ["[email protected]", "[email protected]"],
"detected_event_tech_stack": ["Sessionize", "Cloudflare"],
"lead_priority_score": 95,
"outbound_icebreaker": "Hi Roberth — saw your Sessionize speaker profile and session on 'Platform Engineering on Kubernetes' (35 conference appearances); reaching out regarding upcoming B2B event partnerships."
}
]
}
GET /v1/healthcare/search
Extracts verified private practice therapists, psychologists, dermatologists, plastic surgeons, MedSpas, and dental clinics across Psychology Today, WebMD, RealSelf, and the Official US CMS NPPES NPI Registry (v2.1). Includes direct clinic phones, 10-digit NPI numbers, Authorized Official / Practice Owner names, session fees, accepted insurances, EHR tech stack (SimplePractice, Jane App, PatientPop / Tebra, Zocdoc), patient live-chat intake gaps, and custom B2B outreach icebreakers.
| Parameter | Type | Default | Description |
|---|---|---|---|
| specialty | string | therapist | Clinical specialty: therapist, psychologist, psychiatrist, dermatology, medspa, plastic-surgery, dentist, chiropractor. |
| location | string | chicago-il | City-state slug (e.g., chicago-il, new-york-ny, los-angeles-ca, austin-tx, miami-fl). |
| source | string | all | Directory filter: all, psychology_today, or npi_cms. |
| limit | integer (1-40) | 10 | Maximum enriched healthcare provider & clinic leads to return. |
{
"status": "ok",
"cached": true,
"response_time_ms": 0.41,
"specialty": "therapist",
"location": "chicago-il",
"count": 8,
"summary_analytics": {
"total_providers_enriched": 8,
"direct_phone_numbers_count": 8,
"npi_verified_records_count": 4,
"multi_provider_group_clinics_count": 4,
"clinics_missing_patient_live_chat_count": 8,
"detected_ehr_and_clinic_tech_breakdown": {
"SimplePractice EHR": 4,
"Psychology Today Telehealth": 4,
"PatientPop / Tebra": 4,
"Zocdoc Online Booking": 4
}
},
"items": [
{
"directory_source": "Psychology Today Verified Directory",
"npi_number": "1881371979",
"provider_name": "Carrie Sandler",
"credentials": "LCPC",
"practice_or_clinic_name": "Carrie Sandler Private Practice",
"authorized_official_or_owner": "Carrie Sandler",
"specialty": "Mental Health & Psychotherapy",
"practice_tier": "Verified Private Practice Clinician",
"address": "410 S Michigan Ave, Chicago, IL 60605",
"direct_phone": "(312) 970-0964",
"session_fee_or_pricing": "$190",
"accepted_insurances": ["BlueCross and BlueShield", "Aetna", "Out of Network"],
"inferred_email_patterns": ["[email protected]", "[email protected]"],
"detected_ehr_and_clinic_tech": ["SimplePractice EHR", "Psychology Today Telehealth"],
"missing_patient_live_chat": true,
"lead_priority_score": 88,
"outbound_icebreaker": "Hi Carrie — found your verified Psychology Today practice in Chicago, IL (LCPC); noticed practices in Chicago accepting BlueCross and BlueShield are automating intake follow-ups to reduce no-shows."
}
]
}