AI Rank Tracker

An Apify actor that tracks website rankings for specific keywords across multiple AI platforms (ChatGPT, Gemini, Perplexity, Claude). This actor helps you monitor how your website performs in AI-generated search results and product recommendations.

Features

• Multi-Platform Tracking: Monitors rankings across ChatGPT, Gemini, Perplexity, and Claude
• Geo-Targeted Results: Supports country-specific search results
• Product Listings: Tracks product/service mentions and rankings
• Visibility Scoring: Provides visibility scores for your domain
• Error Handling: Robust error handling with detailed error messages

Input

The actor expects the following input parameters:

Field	Type	Required	Description
url	String	Yes	The website URL to track (e.g., "https://linkcoasters.com/")
keyword	String	Yes	The target keyword to track rankings for
countryCode	String	Yes	Two-letter country code for geo-targeted results (e.g., "US")

Example Input

{
  "url": "https://linkcoasters.com/",
  "keyword": "high authority backlinks",
  "countryCode": "US"
}

Output

The actor returns comprehensive ranking data in the following CSV format with these columns:

Column	Description
domain	The domain being tracked (extracted from URL)
keyword	The target keyword searched
countryCode	Two-letter country code used
url	The full website URL being tracked
visibilityScore	Overall visibility score for the domain
chatgpt_rank	Direct ranking position in ChatGPT results
chatgpt_mentioned	Whether domain was mentioned in ChatGPT
chatgpt_product_listing	JSON array of ChatGPT product listings
gemini_rank	Direct ranking position in Gemini results
gemini_mentioned	Whether domain was mentioned in Gemini
gemini_product_listing	JSON array of Gemini product listings
perplexity_rank	Direct ranking position in Perplexity results
perplexity_mentioned	Whether domain was mentioned in Perplexity
perplexity_product_listing	JSON array of Perplexity product listings
claude_rank	Direct ranking position in Claude results
claude_mentioned	Whether domain was mentioned in Claude
claude_product_listing	JSON array of Claude product listings

Product Listing Format

Each *_product_listing column contains a JSON array with the following structure:

[
  {
    "rank": 3,
    "clean_name": "SnapLogic",
    "product_name": "SnapLogic",
    "is_target_domain": false
  },
  {
    "rank": 4,
    "clean_name": "FusionReactor",
    "product_name": "FusionReactor",
    "is_target_domain": false
  }
]

Product Listing Fields:

• rank: Position in the product listing
• clean_name: Standardized product name
• product_name: Original product name as returned by AI
• is_target_domain: Boolean indicating if this is your tracked domain

Supported Countries

The actor supports geo-targeted results for major countries including:

• US (United States)
• GB (United Kingdom)
• CA (Canada)
• AU (Australia)
• DE (Germany)
• FR (France)
• ES (Spain)
• IT (Italy)
• BR (Brazil)
• MX (Mexico)
• JP (Japan)
• KR (South Korea)
• IN (India)
• And more...

Use Cases

1. SEO Monitoring: Track how your website ranks in AI search results
2. Competitor Analysis: Monitor competitor visibility across AI platforms
3. Content Strategy: Understand which topics/keywords work best for AI visibility
4. Market Research: Discover trending products and services in your niche
5. Brand Monitoring: Track brand mentions across AI platforms

AI Platform Coverage

This actor tracks rankings across four major AI platforms:

• ChatGPT: OpenAI's conversational AI platform
• Gemini: Google's AI platform (formerly Bard)
• Perplexity: AI-powered search and answer engine
• Claude: Anthropic's AI assistant platform

API Integration

This actor integrates with a specialized rank tracking API that queries multiple AI platforms simultaneously. The API handles the complex task of:

• Querying different AI platforms with consistent parameters
• Parsing and normalizing responses from each platform
• Extracting ranking positions and product listings
• Providing structured, comparable data across platforms

Error Handling

The actor includes comprehensive error handling:

• Input Validation: Ensures all required fields are provided
• API Errors: Handles API failures gracefully with detailed error messages
• Network Issues: Manages connection timeouts and network problems
• Data Processing: Validates and structures response data

Rate Limits

Please be aware of potential rate limits when using this actor:

• The underlying API may have usage limits
• Consider spacing out requests for large-scale monitoring
• Use Apify's scheduling features for regular monitoring

Getting Started

1. Set up your input: Provide the website URL, target keyword, and country code
2. Run the actor: Execute through Apify Console or API
3. Analyze results: Review rankings across all AI platforms
4. Export data: Download results in CSV format for further analysis
5. Schedule regular runs: Set up monitoring schedules for ongoing tracking

Data Analysis Tips

• Use the visibilityScore to get an overall performance metric
• Compare *_rank values across platforms to identify strengths/weaknesses
• Analyze *_product_listing JSON to understand competitive landscape
• Filter by is_target_domain: true to find your domain's specific mentions
• Track changes over time by running regular monitoring schedules

Technical Details

• Runtime: Python 3.11+
• Dependencies: aiohttp, apify
• Architecture: Async/await for efficient API calls
• Data Storage: Results automatically saved to Apify dataset in CSV format

Support

For issues or questions:

1. Check the actor logs for detailed error messages
2. Verify your input parameters match the required format
3. Ensure your target website is accessible and properly configured
4. Contact support if API-related issues persist

---

This actor is designed for legitimate SEO and marketing research purposes. Please respect platform terms of service and rate limits.