Beta API

SEO API Documentation

Comprehensive SEO analysis including meta tags, performance metrics, and optimization recommendations

SEO Analysis API - New!

Comprehensive SEO analysis for any webpage. Get detailed scores, recommendations, and actionable insights to improve search rankings. Contact us to get your API key!

SEO Analysis Endpoint

GET /seo?url={url}

Analyze any webpage for SEO best practices. Get comprehensive scores for title, meta description, headings, content quality, images, and links with actionable recommendations.

Parameters:

url - The URL to analyze for SEO (required)

Authentication:

API key required via X-API-Key: YOUR_API_KEY header

SEO Analysis Example

curl "https://api.ogfetch.com/seo?url=https://example.com" \
  -H "X-API-Key: ogf_live_your_api_key_here"

Response Schema & SEO Score Card

C+70/100

SEO Score

https://example.com

Title80

Meta description0

Headings100

Images100

Links70

Content60

Recommendations

•Title too short - aim for 30-60 characters
•Missing meta description
•Add at least one internal link
•Content too short for the topic

Overall grade, per-metric breakdown, and recommendations to act on.

Response Schema

SEO Analysis Response

{
  "url": "https://example.com",
  "analyzed_at": "2025-07-18T21:52:27Z",
  "overall_score": 70,
  "grade": "C+",
  "title_analysis": {
    "score": 80,
    "text": "Example Domain",
    "length": 14,
    "optimal_length": false,
    "issues": ["Title too short - aim for 30-60 characters"]
  },
  "meta_description": {
    "score": 0,
    "present": false,
    "text": "",
    "length": 0,
    "optimal_length": false,
    "issues": ["Missing meta description"]
  },
  "heading_analysis": {
    "score": 100,
    "h1_count": 1,
    "h1_text": "Example Domain",
    "hierarchy_valid": true,
    "total_headings": 1,
    "issues": []
  },
  "image_analysis": {
    "score": 100,
    "total_images": 0,
    "missing_alt": 0,
    "alt_text_quality": "excellent",
    "issues": []
  },
  "link_analysis": {
    "score": 90,
    "internal_links": 0,
    "external_links": 1,
    "issues": ["No internal links found - add navigation links"]
  },
  "content_analysis": {
    "score": 80,
    "word_count": 28,
    "readability": "poor",
    "issues": ["Content too short - aim for at least 300 words"]
  },
  "recommendations": [
    {
      "priority": "high",
      "title": "Title Optimization",
      "description": "Title too short - aim for 30-60 characters",
      "impact": "high"
    },
    {
      "priority": "high",
      "title": "Meta Description",
      "description": "Missing meta description",
      "impact": "high"
    },
    {
      "priority": "low",
      "title": "Content Quality",
      "description": "Content too short - aim for at least 300 words",
      "impact": "medium"
    }
  ]
}

Analysis Components

overall_score: Combined SEO score (0-100) with letter grade

title_analysis: Title optimization, length, and keyword usage

meta_description: Meta description presence, length, and quality

heading_analysis: H1-H6 structure, hierarchy, and optimization

image_analysis: Alt text usage, image optimization, and accessibility

link_analysis: Internal/external link balance and quality

content_analysis: Word count, readability, and content quality

recommendations: Prioritized action items with impact assessment

Detailed Scoring System

Overall Score Formula

Overall = (Title × 25%) + (Meta × 20%) + (Headings × 20%) + (Content × 20%) + (Images × 10%) + (Links × 5%)

Component Scoring Details

Title Analysis (25%)

• Missing title: 0 points

• Too short (<30 chars): -20 points

• Too long (>60 chars): -10 points

• Optimal (30-60 chars): 100 points

Meta Description (20%)

• Missing: 0 points

• Too short (<120 chars): -20 points

• Too long (>160 chars): -10 points

• Optimal (120-160 chars): 100 points

Headings (20%)

• Missing H1: -30 points

• Multiple H1s: -20 points

• Exactly 1 H1: 100 points

Content Quality (20%)

• <300 words: -20 points

• 300-999 words: 100 points

• 1000+ words: 100 points

Images (10%)

• Missing alt text: -10 per image

• All images with alt: 100 points

• No images: 100 points (no penalty)

Links (5%)

• No internal links: -10 points

• Has internal links: 100 points

Example Calculation

Example Page:

• Title: "SEO Guide" (15 chars) = 80 pts

• Meta: Missing = 0 pts

• H1: One H1 found = 100 pts

• Content: 250 words = 80 pts

• Images: All have alt text = 100 pts

• Links: Has internal links = 100 pts

Final Score: (80×0.25) + (0×0.20) + (100×0.20) + (80×0.20) + (100×0.10) + (100×0.05) = 67/100 (D+)

Use Cases

SEO Audit Tools

Build comprehensive SEO auditing platforms with detailed recommendations

Content Optimization

Analyze pages before publishing to ensure optimal SEO performance

Competitive Analysis

Compare your pages against competitors to identify optimization opportunities