Citation God Mode - Ultimate NAP Consistency Checker

The most comprehensive citation checker on Apify. Combines 24 dedicated platform scrapers, Firecrawl AI-powered extraction for 40+ additional directories, cross-validation engine, and Claude AI-powered analysis. Get the definitive truth about your business citations across 60+ directories.

Key Features

Multi-Layer Data Collection

1. Dedicated Scrapers (24 platforms) - Custom Apify actors for maximum reliability on major platforms
2. Firecrawl AI Extraction (40+ platforms) - AI-powered data extraction for directories without dedicated scrapers
3. CSS-Based Scraping (fallback) - Traditional DOM scraping with stealth Firefox/Camoufox
4. Google Business Profile Integration - Use GBP as source of truth for NAP validation

Intelligent Analysis

• Cross-Validation Engine - Weighted voting system determines the "canonical" NAP from all sources
• Claude AI Analysis - Powered by Claude Sonnet 4, provides actionable recommendations and priority fixes
• Industry Relevance Filtering - Skip platforms irrelevant to your business type (e.g., skip Healthgrades for plumbers)

Performance Optimizations

• 5x Parallel CSS Scraping - Run 5 browser instances concurrently
• 5x Parallel Dedicated Scrapers - Execute dedicated actor batches in parallel
• 5x Parallel Firecrawl Requests - AI extraction runs in parallel batches
• Intelligent Fallback Chain - Dedicated scraper → Firecrawl → CSS scraping

Supported Platforms

Dedicated Scrapers (Highest Reliability)

Platform	Category	Confidence
Yelp	Reviews	95%
Yellow Pages	Directory	95%
Angi	Home Services	95%
TripAdvisor	Reviews	95%
BBB	Business Bureau	95%
Apple Maps	Maps	95%
Bing Places	Maps	95%
Healthgrades	Healthcare	95%
Avvo	Legal	95%
Manta	Directory	90%
Houzz	Home Services	90%
Trustpilot	Reviews	90%
Glassdoor	Employer	90%
HomeAdvisor	Home Services	90%
G2	Software	90%
Capterra	Software	90%
Clutch	B2B Services	90%
Facebook	Social	90%
DoorDash	Food Delivery	85%
Grubhub	Food Delivery	85%
Uber Eats	Food Delivery	85%
GoodFirms	B2B Services	85%
Crunchbase	Business DB	85%

Firecrawl AI Extraction (40+ Platforms)

Foursquare, Citysearch, Superpages, Mapquest, Local.com, Merchantcircle, Cylex, Hotfrog, Brownbook, Chamber of Commerce, Ezlocal, Showmelocal, Tupalo, 2findlocal, Spoke, Elocal, n49, Cityfos, Justlanded, Opendi, Cybo, Hub.biz, Citysquares, Startlocal, Bizwiki, Wand, Tuugo, FindUsLocal, Locanto, Citiservi, Golocal247, Iglobal, USCity.net, Infignos, Fyple, Bizhwy, D&B, Expressbusinessdirectory, Ebusinesspages, Salespider, Localstack

Quick Start

Basic Usage

{
  "businessName": "Acme Plumbing Co",
  "streetAddress": "123 Main St",
  "city": "Miami",
  "state": "FL",
  "zipCode": "33101",
  "phone": "(305) 555-1234",
  "scanMode": "god-mode"
}

With All Features Enabled

{
  "businessName": "Acme Plumbing Co",
  "streetAddress": "123 Main St",
  "city": "Miami",
  "state": "FL",
  "zipCode": "33101",
  "phone": "(305) 555-1234",
  "website": "https://acmeplumbing.com",
  "industry": "plumbing",
  "googlePlaceId": "ChIJ...",
  "scanMode": "god-mode",
  "enableDirectScrape": true,
  "useDedicatedScrapers": true,
  "enableFirecrawl": true,
  "firecrawlApiKey": "fc-...",
  "enableCrossValidation": true,
  "enableAiAnalysis": true,
  "anthropicApiKey": "sk-ant-..."
}

Input Parameters

Parameter	Type	Required	Default	Description
businessName	string	Yes	-	Business name to search for
streetAddress	string	No	-	Street address
city	string	Yes	-	City name
state	string	Yes	-	State code (e.g., "FL")
zipCode	string	No	-	ZIP code
phone	string	No	-	Phone number to validate
website	string	No	-	Website URL
industry	string	No	-	Business industry for relevance filtering
googlePlaceId	string	No	-	GBP Place ID (makes GBP source of truth)
scanMode	string	No	"standard"	"quick", "standard", "deep", or "god-mode"
enableMozScan	boolean	No	true	Enable Moz Local Listings check
enableDirectScrape	boolean	No	true	Enable direct platform scraping
useDedicatedScrapers	boolean	No	true	Use dedicated Apify actors
enableFirecrawl	boolean	No	true	Use Firecrawl AI extraction
firecrawlApiKey	string	No	-	Firecrawl API key
enableCrossValidation	boolean	No	true	Run cross-validation engine
enableAiAnalysis	boolean	No	true	Run Claude AI analysis
anthropicApiKey	string	No	-	Anthropic API key for AI analysis
platforms	array	No	-	Specific platforms to check
providedUrls	object	No	-	Pre-known listing URLs
webhookUrl	string	No	-	Webhook for results notification
demoMode	boolean	No	false	Return sample data (no charges)

Scan Modes

Mode	Platforms	Speed	Use Case
quick	~10	1-2 min	Quick health check
standard	~30	3-5 min	Regular audits
deep	~45	5-8 min	Comprehensive analysis
god-mode	60+	8-15 min	Ultimate audit with all features

Output Format

{
  "businessName": "Acme Plumbing Co",
  "inputNAP": {
    "name": "Acme Plumbing Co",
    "address": "123 Main St, Miami, FL 33101",
    "phone": "(305) 555-1234"
  },
  "canonicalNAP": {
    "canonicalName": "Acme Plumbing Co",
    "canonicalAddress": "123 Main St, Miami, FL 33101",
    "canonicalPhone": "(305) 555-1234",
    "confidence": 92,
    "sources": [...],
    "variations": {
      "names": ["Acme Plumbing Co", "Acme Plumbing"],
      "addresses": ["123 Main St, Miami, FL 33101", "123 Main Street"],
      "phones": ["(305) 555-1234", "305-555-1234"]
    }
  },
  "overallScore": "B+",
  "healthScore": 78,
  "summary": {
    "totalChecked": 62,
    "correct": 45,
    "incorrect": 8,
    "missing": 5,
    "found": 2,
    "errors": 2,
    "notApplicable": 12
  },
  "mergedResults": [
    {
      "platform": "Yelp",
      "source": "direct",
      "status": "correct",
      "url": "https://yelp.com/biz/...",
      "foundName": "Acme Plumbing Co",
      "foundAddress": "123 Main St, Miami, FL 33101",
      "foundPhone": "(305) 555-1234",
      "nameMatch": true,
      "addressMatch": true,
      "phoneMatch": true,
      "rating": 4.8,
      "reviewCount": 127,
      "confidence": 95,
      "checkedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "aiAnalysis": {
    "overallHealthScore": 78,
    "summary": "Your citations are moderately healthy with 45 correct listings...",
    "correctionSuggestions": [
      {
        "platform": "Manta",
        "field": "phone",
        "currentValue": "(305) 555-1111",
        "suggestedCorrection": "(305) 555-1234",
        "priority": "high",
        "reasoning": "Phone mismatch on major directory impacts customer contact"
      }
    ],
    "prioritizedActions": [
      "Fix phone number on Manta immediately",
      "Claim missing Bing Places listing",
      "Update address on Foursquare"
    ],
    "estimatedImpact": "Fixing these issues could improve local pack visibility by 15-25% within 4-6 weeks."
  },
  "recommendations": [
    "Fix NAP inconsistencies on 8 platform(s)",
    "Claim missing listings: Bing Places, Apple Maps...",
    "Complete 2 listing(s) with full NAP data"
  ],
  "checkedAt": "2024-01-15T10:45:00Z",
  "scanMode": "god-mode"
}

Citation Status Types

Status	Description
correct	NAP matches exactly (or within tolerance)
incorrect	Listing found but NAP has mismatches
missing	No listing found on platform
found	Listing found but couldn't extract full NAP
incomplete	Partial NAP data extracted
error	Scraping failed for this platform
n/a	Platform not relevant to business industry
duplicate	Duplicate listing detected

Pricing

This actor uses pay-per-event billing:

Mode	Price	Best For
Demo	Free	Testing the actor
Quick	$0.05	Health check
Standard	$0.15	Monthly audits
Deep	$0.35	Quarterly reviews
God Mode	$0.50	Initial/annual audits

API Costs (if using):

• Firecrawl: ~$0.01-0.03 per platform (your API key)
• Anthropic: ~$0.02-0.05 per analysis (your API key)

Use Cases

For SEO Agencies

• Run monthly audits for all clients
• Export results to CSV for white-label reports
• Track citation health trends over time
• Prioritize fixes by AI-suggested impact

For Local Businesses

• Get a complete picture of your online presence
• Know exactly which directories need updating
• Identify NAP inconsistencies hurting your rankings
• Discover missing citations on important platforms

For Enterprise

• Audit multi-location businesses at scale
• Integrate via webhook for automated monitoring
• Use industry filtering for relevant platform coverage
• Cross-validate NAP against internal records

Integration Examples

Webhook Integration

{
  "businessName": "Acme Plumbing",
  "city": "Miami",
  "state": "FL",
  "webhookUrl": "https://your-app.com/webhook/citations"
}

Zapier/Make Integration

Use Apify's native integrations to:

• Trigger scans from Google Sheets
• Send results to Slack/email
• Update CRM records
• Create Notion pages

Common Issues & Solutions

"Rate limit exceeded"

Cause: Too many concurrent scraping requests. Fix: The actor automatically handles rate limits with backoff. If persistent, try reducing maxConcurrency or using Quick mode.

Demo data showing instead of real results

Cause: Either demoMode: true is set, or required fields are missing. Fix: Ensure demoMode: false and provide businessName, city, and state.

Low confidence scores

Cause: Business has limited online presence or highly variable NAP. Fix: This is expected for new businesses. Focus on claiming listings on high-priority platforms first.

Firecrawl not finding listings

Cause: Firecrawl API key not provided or invalid. Fix: Get an API key from firecrawl.dev and provide it as firecrawlApiKey.

AI analysis not working

Cause: Anthropic API key not provided. Fix: Get an API key from console.anthropic.com and provide it as anthropicApiKey.

Changelog

v1.0.25 (2024-02)

• Added Firecrawl AI extraction for 40+ platforms
• Added 15 new dedicated scrapers (BBB, Apple Maps, Bing Places, etc.)
• Increased parallelism from 2x to 5x for all scraping methods
• Added industry relevance filtering
• Improved cross-validation engine with weighted voting
• Enhanced error handling and fallback chain

v1.0.0 (2024-01)

• Initial release with 9 dedicated scrapers
• Cross-validation engine
• Claude AI analysis
• Camoufox stealth browser support

---

📞 Support

• Actor Arsenal: Full Actor Catalog
• Developer: John Rippy

---

Built by John Rippy | Actor Arsenal