UnrealSEO Integrations

🎯 Quick Summary

Connect UnrealSEO with your existing content stack (WordPress, Shopify, CMS)
Automate citation tracking, content optimization, and reporting
One-click plugins for major platforms (WP, Wix, Squarespace, Webflow)
API integration for custom workflows and enterprise systems
Sync data with analytics tools (GA4, Mixpanel, Amplitude)

🔑 Key Concepts at a Glance

CMS Plugin: Pre-built integration for content platforms
API Integration: Custom connection via UnrealSEO API
Webhook: Real-time event notifications (citation changes)
Data Sync: Automatic bi-directional data synchronization
Native Integration: Official partnership integration

🏷️ Metadata

Tags: platform, integrations, cms, api, plugins Status: %%ACTIVE%% Complexity: %%MODERATE%% Max Lines: 450 (this file: 445 lines) Reading Time: 10 minutes Last Updated: 2025-01-18

Integration Overview

Why Integrate?

Benefits of integrating UnrealSEO:

Without Integration:
1. Manually copy content URLs to UnrealSEO
2. Run citation tests
3. Copy optimization recommendations
4. Manually update content in CMS
5. Manually track results
6. Export data, import to analytics

Time: 2-4 hours weekly

With Integration:
1. Publish content in your CMS
   → Auto-tracked by UnrealSEO
   → Auto-tested for citations
   → Recommendations appear in CMS editor
   → One-click optimizations applied
   → Results auto-synced to analytics

Time: 5 minutes weekly

Integration Types

Three integration levels:

Level 1: Basic (Sitemap Sync)
- UnrealSEO crawls your sitemap
- No plugin installation required
- Automatic page discovery
- Citation tracking
Setup: 5 minutes

Level 2: Plugin (CMS Integration)
- Install plugin in WordPress/Shopify/etc.
- In-editor optimization suggestions
- One-click schema implementation
- Content audit tools
Setup: 10-15 minutes

Level 3: API (Custom Integration)
- Full programmatic access
- Custom workflows
- Enterprise system integration
- White-label possibilities
Setup: Developer time varies

Content Management Systems

WordPress Integration

Official WordPress Plugin:

Plugin: UnrealSEO for WordPress
Version: 2.4.1
Installs: 45,000+
Rating: 4.8/5 (2,340 reviews)

Features:
✓ Citation tracking for all posts/pages
✓ In-editor optimization sidebar
✓ One-click schema markup
✓ AI-friendly content templates
✓ Gutenberg block for structured data
✓ Classic editor support
✓ Multisite compatible

Installation (2 minutes):

Step 1: Install Plugin
WordPress Admin → Plugins → Add New
Search: "UnrealSEO"
→ Install Now → Activate

Step 2: Connect Account
Settings → UnrealSEO → API Key
Enter your UnrealSEO API key
→ Save

Step 3: Configure
Auto-track: [x] All published posts
         [x] All published pages
         [ ] Drafts
Citation check: Weekly
→ Save Settings

Done! All content now auto-tracked.

In-Editor Features:

WordPress Post Editor:

[Edit Post: "CRM Buyer's Guide"]

┌─────────────────────────────────────┐
│ UnrealSEO Sidebar                   │
├─────────────────────────────────────┤
│ Citation Status:                    │
│ ✓ ChatGPT: Cited (position 2)      │
│ ✗ Claude: Not cited                │
│ ✓ Gemini: Cited (position 3)       │
│ ✗ Perplexity: Not cited            │
│                                     │
│ Citation Rate: 50% (2/4)           │
│ Target: 75%                         │
│                                     │
│ Optimization Opportunities:         │
│ 1. Add FAQPage schema               │
│    [Add Schema] ← One-click button  │
│                                     │
│ 2. Improve answer-first intro       │
│    [View Suggestion]                │
│                                     │
│ 3. Add author credentials           │
│    [Configure Author]               │
│                                     │
│ Expected Impact: +25pp cite rate    │
└─────────────────────────────────────┘

Webflow Integration

Native Webflow App:

App: UnrealSEO Citation Tracker
Available: Webflow App Marketplace

Features:
✓ Auto-sync published pages
✓ CMS collection integration
✓ Custom code injection (schema)
✓ Citation metrics in CMS panel
✓ Optimization recommendations

Setup:
1. Webflow Dashboard → Apps → Add Apps
2. Search "UnrealSEO" → Add to site
3. Authorize with UnrealSEO account
4. Select collections to track
5. Publish site → Auto-tracking begins

Shopify Integration

Shopify App:

App: UnrealSEO for E-commerce
Available: Shopify App Store

E-commerce Specific Features:
✓ Product page citation tracking
✓ Product schema auto-generation
✓ Review schema integration
✓ Shopping AI optimization (ChatGPT Shopping)
✓ Product discovery analytics

Installation:
1. Shopify Admin → Apps → Visit Shopify App Store
2. Search "UnrealSEO" → Add app
3. Authorize permissions
4. Configure product tracking
5. Auto-track products + collections

Other CMS Platforms

Supported platforms:

┌──────────────┬────────────┬──────────────────┐
│ Platform     │ Type       │ Setup Time       │
├──────────────┼────────────┼──────────────────┤
│ WordPress    │ Plugin     │ 2 min            │
│ Shopify      │ App        │ 3 min            │
│ Webflow      │ Native App │ 5 min            │
│ Wix          │ App        │ 5 min            │
│ Squarespace  │ Code Block │ 10 min           │
│ Ghost        │ Integration│ 10 min           │
│ Contentful   │ API        │ 15 min (dev)     │
│ Drupal       │ Module     │ 10 min           │
│ Joomla       │ Extension  │ 10 min           │
│ Custom CMS   │ API        │ Varies           │
└──────────────┴────────────┴──────────────────┘

See detailed setup guides: [CMS Plugins](./cms-plugins)

E-commerce Platforms

Shopping AI Optimization

Integrate for AI shopping assistants:

Platforms supporting shopping AI:
• ChatGPT Shopping
• Google Shopping Graph
• Amazon Rufus
• Perplexity Shopping

UnrealSEO E-commerce Features:
✓ Product citation tracking
✓ Product schema optimization
✓ Price comparison monitoring
✓ Review schema integration
✓ Inventory signals
✓ Shipping data optimization

BigCommerce Integration

App: UnrealSEO Product Optimizer

Features:
• Bulk product schema generation
• Citation tracking per product
• Category page optimization
• Automated A/B testing
• ROI tracking (citations → sales)

Setup:
BigCommerce Control Panel → Apps → Marketplace
Search: UnrealSEO → Install → Connect account

WooCommerce (WordPress)

Plugin: UnrealSEO + WooCommerce Addon

Additional Features (beyond WordPress base):
• Product-specific citation tracking
• WooCommerce schema integration
• Cart/checkout page exclusion
• Product category tracking
• Variable product support

Install: WordPress → Plugins → "UnrealSEO WooCommerce"

Analytics & Data

Google Analytics 4 (GA4)

Sync citation data to GA4:

Integration: UnrealSEO → GA4 Custom Dimensions

Custom Dimensions Created:
• ai_citation_rate (metric)
• ai_platform (dimension)
• cited_by_ai (yes/no dimension)
• query_score (metric)

Setup (5 minutes):
1. UnrealSEO Dashboard → Integrations → GA4
2. Enter GA4 Measurement ID
3. Authorize Google Account
4. Select custom dimensions to sync
5. Save → Data flows to GA4 in 24 hours

View in GA4:
Reports → Engagement → Custom → "AI Citations"

GA4 Custom Report:

AI Citation Performance Report (GA4)

Dimensions:
• Page Title
• Page Path
• AI Citation Rate
• Cited By AI

Metrics:
• Sessions
• Conversions
• Revenue
• Citation Rate

Filter: Cited By AI = Yes
Comparison: vs Cited By AI = No

Result: See revenue lift from AI citations
Example: Cited pages: $127 avg revenue
        Non-cited pages: $42 avg revenue
        Lift: +202% revenue when cited by AI

Mixpanel Integration

Integration: Event streaming to Mixpanel

Events Sent:
• citation_gained (when new citation detected)
• citation_lost (when citation removed)
• citation_rate_milestone (25%, 50%, 75%, 100%)
• optimization_applied (when content optimized)

Setup:
UnrealSEO → Integrations → Mixpanel
Enter Mixpanel Project Token → Save

Use Case: Track user journey from citation to conversion

Data Warehouses

Export to data warehouse:

Supported Warehouses:
• Google BigQuery
• Snowflake
• Amazon Redshift
• Databricks

Integration Method: Scheduled exports

Configuration:
UnrealSEO → Integrations → Data Export
Select: BigQuery
Frequency: Daily at 3 AM UTC
Tables to export:
  [x] Citations
  [x] Queries
  [x] Content Performance
  [x] Competitor Data

Data arrives in your warehouse for custom analysis

Marketing Tools

Slack Integration

Real-time citation alerts:

Integration: UnrealSEO → Slack

Notifications Sent:
• 🎉 New citation gained
• ⚠️ Citation lost (competitor took position)
• 📈 Milestone reached (30% citation rate!)
• 🚨 Critical drops (>10pp decline)

Setup:
1. UnrealSEO → Integrations → Slack
2. Click "Add to Slack"
3. Select channel: #llm-marketing
4. Configure alert types
5. Save

Example Alert:
UnrealSEO Bot [3:24 PM]
🎉 New citation gained!

Query: "best CRM software 2025"
Platform: ChatGPT
Your Position: #2
Page: /crm-buyer-guide

This is your 23rd citation this month! 📈

Zapier Integration

Connect to 5,000+ apps:

UnrealSEO Zapier Triggers:
• New citation detected
• Citation rate milestone
• Content optimization recommended
• Competitor cited (gap identified)

Example Zap:
Trigger: New citation detected
Action: Create Notion page
  → Add to "Content Wins" database
  → Tag author for recognition
  → Update team dashboard

Email Marketing (HubSpot/Mailchimp)

Integration: Citation data → Email segments

Use Case: Personalized email based on AI citations

Example:
Segment: "Leads who viewed AI-cited content"
→ Higher engagement, better conversions

HubSpot Smart List:
• Contact visited page
• Page has property: ai_citation_rate > 50%
→ Add to "High Intent" segment
→ Send personalized follow-up

Setup:
UnrealSEO → Integrations → HubSpot
Sync citation data as custom page properties

Developer API

REST API Overview

Full programmatic access:

API Base: https://api.unrealseo.com/v1

Authentication: Bearer token

Example Request:
GET /queries/123/citations
Authorization: Bearer YOUR_API_KEY

Response:
{
  "query": "best CRM software",
  "citation_rate": 0.75,
  "citations": [
    {
      "platform": "chatgpt",
      "cited": true,
      "position": 2,
      "timestamp": "2025-01-18T14:30:00Z"
    },
    {
      "platform": "claude",
      "cited": false,
      "timestamp": "2025-01-18T14:30:00Z"
    }
  ]
}

API Endpoints

Core endpoints:

Queries:
POST   /queries              Create new query to track
GET    /queries              List all queries
GET    /queries/{id}         Get query details
DELETE /queries/{id}         Delete query

Citations:
GET    /queries/{id}/citations    Get citation status
POST   /queries/{id}/test         Test query now

Content:
GET    /content                   List tracked content
GET    /content/{id}              Get content performance
POST   /content                   Add content to track

Analytics:
GET    /analytics/summary         Overall metrics
GET    /analytics/trends          Historical trends
GET    /analytics/competitors     Competitor data

Webhooks:
POST   /webhooks                  Create webhook
GET    /webhooks                  List webhooks
DELETE /webhooks/{id}             Delete webhook

Webhook Events

Real-time notifications:

Subscribe to events:

POST /webhooks
{
  "url": "https://yourapp.com/webhook",
  "events": ["citation.gained", "citation.lost"],
  "secret": "your_webhook_secret"
}

Webhook Payload (citation.gained):
{
  "event": "citation.gained",
  "timestamp": "2025-01-18T14:30:00Z",
  "data": {
    "query_id": 123,
    "query": "best CRM software",
    "platform": "chatgpt",
    "position": 2,
    "content_id": 456,
    "content_url": "https://yoursite.com/crm-guide"
  },
  "signature": "sha256_signature_here"
}

Verify signature to ensure authenticity

Code Examples

Python SDK:

from unrealseo import UnrealSEO

# Initialize client
client = UnrealSEO(api_key="your_api_key")

# Add query to track
query = client.queries.create(
    query="best CRM software",
    platforms=["chatgpt", "claude", "gemini", "perplexity"],
    track_frequency="daily"
)

# Get citation status
citations = client.queries.get_citations(query.id)
print(f"Citation Rate: {citations.citation_rate}")

# Test query now
result = client.queries.test(query.id)
for platform in result:
    print(f"{platform.name}: {'✓' if platform.cited else '✗'}")

JavaScript/Node.js SDK:

const UnrealSEO = require('unrealseo');

const client = new UnrealSEO({ apiKey: 'your_api_key' });

// Get analytics summary
async function getMetrics() {
  const analytics = await client.analytics.summary({
    dateRange: 'last_30_days'
  });

  console.log(`Citation Rate: ${analytics.citationRate}%`);
  console.log(`Share of Voice: ${analytics.shareOfVoice}%`);

  return analytics;
}

// Track new content
async function trackContent(url) {
  const content = await client.content.create({
    url: url,
    autoTrack: true
  });

  return content.id;
}

Custom Integrations

Enterprise SSO

Single Sign-On integration:

Supported Protocols:
• SAML 2.0
• OAuth 2.0
• OpenID Connect

Enterprise Providers:
• Okta
• Azure AD
• Google Workspace
• OneLogin

Setup:
Contact: info@unrealseo.com
Provide: IdP metadata URL
Timeline: 2-3 business days for configuration

White Label API

Embed UnrealSEO in your product:

White Label Features:
• Remove UnrealSEO branding
• Custom domain (analytics.yourcompany.com)
• API under your brand
• Custom email notifications
• Your logo/colors in dashboards

Use Cases:
• Agency client dashboards
• SaaS platform add-on feature
• Enterprise internal tools

Pricing: Enterprise plan
Contact: info@unrealseo.com

Custom Workflow Examples

Example 1: Automated content optimization:

Workflow: Auto-optimize low-performing content

1. Daily cron job fetches content with citation rate < 20%
2. For each page:
   a. Get optimization recommendations via API
   b. Apply schema markup automatically
   c. Update meta descriptions
   d. Trigger content re-index
3. Track improvements over 30 days
4. Generate report

Code: See GitHub.com/unrealseo/automation-examples

Example 2: Citation-triggered publishing:

Workflow: Publish related content when citation gained

1. Webhook: citation.gained event received
2. Identify topic/query of citation
3. Check content library for related unpublished posts
4. Auto-publish related content (riding momentum)
5. Track if related content also gets cited

Result: 34% higher citation rate for related content
when published within 48 hours of original citation

Integration Guides:

CMS Plugins Setup

Platform:

Developer Resources:

🆘 Need Help?

Integration Support:

Developer Resources:

Enterprise:

📧 info@unrealseo.com
📞 Schedule a call: calendly.com/unrealseo

Last updated: 2025-01-18 | Edit this page

🎯 Quick Summary​

📋 Table of Contents​

🔑 Key Concepts at a Glance​

🏷️ Metadata​

Integration Overview​

Why Integrate?​

Integration Types​

Content Management Systems​

WordPress Integration​

Webflow Integration​

Shopify Integration​

Other CMS Platforms​

E-commerce Platforms​

Shopping AI Optimization​

BigCommerce Integration​

WooCommerce (WordPress)​

Analytics & Data​

Google Analytics 4 (GA4)​

Mixpanel Integration​

Data Warehouses​

Marketing Tools​

Slack Integration​

Zapier Integration​

Email Marketing (HubSpot/Mailchimp)​

Developer API​

REST API Overview​

API Endpoints​

Webhook Events​

Code Examples​

Custom Integrations​

Enterprise SSO​

White Label API​

Custom Workflow Examples​

📚 Related Topics​

🆘 Need Help?​