Pro Feature

API Access

Integrate our powerful SEO analysis tools directly into your applications. Available to both Pro Basic and Pro Plus subscribers.

Powerful SEO data at your fingertips

Access our comprehensive SEO analysis capabilities programmatically through our REST API. Build custom dashboards, automate workflows, and integrate SEO insights directly into your applications.

API Access Comparison

FeaturePro BasicPro Plus
API AccessLimitedExtended
Daily Request Limit300 requests/day1000 requests/day
Burst Limit10 requests/minute30 requests/minute
Advanced Endpoints
Bulk Operations

What You Can Do With Our API

Custom Dashboards

Build custom SEO dashboards that integrate with your existing tools and workflows. Display real-time SEO metrics alongside your other business data for a comprehensive view of your digital performance.

Automated Workflows

Automate SEO analysis as part of your content publishing workflow. Trigger analyses when new content is published, schedule regular audits, or batch process multiple URLs at once.

Custom Applications

Build specialized applications that leverage our SEO analysis capabilities. Create industry-specific tools, client portals, or internal applications tailored to your unique requirements.

Data Integration

Integrate SEO data with your CRM, marketing automation platform, or business intelligence tools. Combine SEO insights with other data sources for comprehensive analysis and reporting.

API Documentation

Our RESTful API is designed to be simple and intuitive, with comprehensive documentation to help you get started quickly.

API Endpoints

Authentication

All API requests require authentication using your API key:

Authorization: Bearer YOUR_API_KEY

Analyze URL

Perform a comprehensive SEO analysis of a URL:

POST /api/v1/analyze

Request Body:

{
  "url": "https://example.com/page-to-analyze",
  "options": {
    "includeCompetitorAnalysis": true,
    "includeMobileAnalysis": true,
    "depth": "comprehensive"
  }
}

Keyword Analysis

Analyze keywords for a specific URL or domain:

POST /api/v1/keywords/analyze

Request Body:

{
  "url": "https://example.com",
  "keywords": ["seo tools", "keyword research", "backlink analysis"],
  "options": {
    "includeVolume": true,
    "includeDifficulty": true
  }
}

Competitor Analysis

Compare your site against competitors:

POST /api/v1/competitors/analyze

Request Body:

{
  "mainUrl": "https://example.com",
  "competitorUrls": [
    "https://competitor1.com",
    "https://competitor2.com",
    "https://competitor3.com"
  ],
  "options": {
    "includeContentGaps": true,
    "includeBacklinkAnalysis": true
  }
}

Example Response

Response from /api/v1/analyze

{
  "success": true,
  "requestId": "req_12345abcde",
  "timestamp": "2025-02-25T10:30:45Z",
  "data": {
    "url": "https://example.com/page-to-analyze",
    "title": "Example Page Title | Example.com",
    "metaDescription": "This is an example meta description for the page.",
    "scores": {
      "overall": 82,
      "onPage": 88,
      "technical": 76,
      "content": 85,
      "mobile": 79
    },
    "issues": [
      {
        "type": "critical",
        "category": "technical",
        "description": "Page load time exceeds 3 seconds on mobile",
        "impact": "high",
        "recommendation": "Optimize images and minimize render-blocking resources"
      },
      {
        "type": "warning",
        "category": "content",
        "description": "Primary keyword density is below recommended threshold",
        "impact": "medium",
        "recommendation": "Increase primary keyword usage to 1-2% of content"
      }
    ],
    "keywords": {
      "primary": {
        "term": "seo analysis tool",
        "density": 0.8,
        "positions": [
          {"position": "title", "count": 1},
          {"position": "h1", "count": 1},
          {"position": "body", "count": 4}
        ]
      },
      "secondary": [
        {
          "term": "website optimization",
          "density": 0.5,
          "positions": [
            {"position": "h2", "count": 1},
            {"position": "body", "count": 3}
          ]
        }
      ]
    },
    "competitors": {
      "topRanking": [
        {"url": "https://competitor1.com/similar-page", "position": 1},
        {"url": "https://competitor2.com/similar-page", "position": 2}
      ],
      "contentGaps": [
        {"topic": "mobile optimization", "importance": "high"},
        {"topic": "schema markup", "importance": "medium"}
      ]
    }
  }
}

API Rate Limits

Pro Basic and Pro Plus subscribers receive a generous allocation of API requests to support their integration needs. Our fair usage policy ensures reliable service for all users.

EndpointPro BasicPro Plus
/api/v1/analyze300 requests/day1000 requests/day
/api/v1/keywords/analyze500 requests/day1500 requests/day
/api/v1/competitors/analyze200 requests/day800 requests/day
/api/v1/bulk/* (Pro Plus only)Not available100 requests/day

Need higher limits? Contact us about our Enterprise plan for custom API quotas tailored to your needs.

Integration Examples

Get started quickly with these code examples in popular programming languages

JavaScript (Node.js)

const axios = require('axios');

async function analyzeSEO(url) {
  try {
    const response = await axios.post(
      'https://api.seonian.com/v1/analyze',
      {
        url: url,
        options: {
          includeCompetitorAnalysis: true,
          includeMobileAnalysis: true
        }
      },
      {
        headers: {
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
        }
      }
    );
    
    console.log('Analysis results:', response.data);
    return response.data;
  } catch (error) {
    console.error('Error analyzing URL:', error.response?.data || error.message);
    throw error;
  }
}

// Example usage
analyzeSEO('https://example.com');

Python

import requests
import json

def analyze_seo(url):
    api_url = 'https://api.seonian.com/v1/analyze'
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }
    payload = {
        'url': url,
        'options': {
            'includeCompetitorAnalysis': True,
            'includeMobileAnalysis': True
        }
    }
    
    try:
        response = requests.post(api_url, headers=headers, json=payload)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        print(f"Error analyzing URL: {e}")
        return None

# Example usage
results = analyze_seo('https://example.com')
if results:
    print(json.dumps(results, indent=2))

"The Seonian API has been a game-changer for our marketing team. We've integrated it with our content management system to automatically analyze SEO performance as we publish new content. This has improved our organic traffic by 37% in just three months by catching issues before they impact our rankings."

David Nguyen

CTO, TechMarketing Solutions

Ready to Integrate SEO Analysis Into Your Workflow?

Choose the plan that fits your needs and get immediate access to our API.