Pricing

Rating

Developer

Actor stats

Categories

Share

🏢 Firmographic Enrichment Actor

Automatically enrich company data from website URLs using Google SERP AI Mode + Groq LLM.

Input a single URL → Get structured firmographic data:

🚀 Quick Start

1. Get Free API Keys

SerpApi (Google SERP):

• Sign up at https://serpapi.com
• Free tier: 100 searches/month
• Used for AI Overview + organic results

Groq (LLM):

• Sign up at https://console.groq.com
• Free tier: generous rate limits
• Model: llama-3.1-8b-instant (fastest, free)

2. Configure Input

Set these environment variables in your Actor settings:

• SERP_API_KEY
• GROQ_API_KEY

Then provide the input:

{
"websiteUrl":"https://stripe.com"
}

📁 File Structure

firmographic-actor/
├── .actor/
│ ├── actor.json # Actor metadata
│ └── input_schema.json # Input field definitions + UI
├── src/
│ ├── main.js # Actor entrypoint, orchestration
│ ├── serpService.js # Google SERP API queries
│ ├── groqService.js # Groq LLM extraction
│ └── csvUtils.js # CSV output helpers
├── storage/
│ └── key_value_stores/
│ └── default/
│ └── INPUT.json # Local dev input
├── test_local.js # Local test runner
├── Dockerfile # Apify deployment container
├── package.json
└── README.md

🔄 How It Works

URL Input
 │
 ▼
SerpApi(3 queries per company)
 ├── "company.com employees revenue funding"
 ├── "company.com founded year funding stage raised"
 └── "company.com headquarters industry sector"
 │
 ▼
Text aggregation
 ├── AI Overview blocks
 ├── Knowledge Graph attributes
 └── Organic result snippets
 │
 ▼
Groq LLM(llama-3.1-8b-instant)
 └── Structured JSON extraction
 │
 ▼
Output
 ├── Apify Dataset(streaming, per record)
 └── CSVfile(Key-Value Store)

💻 Local Development

# Install dependencies
npminstall
# Set env vars
exportSERP_API_KEY=your_serpapi_key
exportGROQ_API_KEY=your_groq_key
# Run local test (3 example companies)
node test_local.js
# Or run as full Apify actor locally
npx apify-cli run

📤 Output

Apify Dataset

Every record is pushed to the dataset in real-time. Download as JSON, CSV, or XLSX from the Apify console.

Key-Value Store CSV

A firmographic_results.csv file is saved to the actor's Key-Value Store. Download URL format:

https://api.apify.com/v2/key-value-stores/{STORE_ID}/records/firmographic_results.csv

⚡ Performance Tips

• Rate limits: SerpApi free = 100 searches/month (3 per company = ~33 companies free)
• Groq: Very generous free tier, effectively unlimited for this use case
• Concurrency: Keep at 2-3 to avoid hitting SerpApi rate limits
• Delay: 1000ms between requests is safe for free tiers

🆓 Free Alternative APIs

🛠 Deploying to Apify

# Install Apify CLI
npminstall-g apify-cli
# Login
apify login
# Push to Apify
apify push
# Run on Apify cloud
apify call YOUR_USERNAME/firmographic-enrichment