SEO Meta Description Checker

An API that checks whether a website has an SEO-friendly title and meta description by validating their presence, length, and overall quality, then generating a simple SEO score.

---

Description

SEO Meta Description Checker analyzes the <title> tag and <meta name="description"> tag of web pages to identify common on-page SEO issues. It verifies whether these tags exist, checks their character length against best practices, and evaluates their basic quality to produce an easy-to-understand SEO score.

This API is useful for:

• SEO audits and quick on-page checks
• Developers building SEO tools or dashboards
• Digital marketers reviewing multiple pages
• Automation workflows for website quality monitoring

---

Features

• Extracts page title and meta description
• Validates presence of both tags
• Calculates character length
• Detects common SEO issues (missing, too short, too long, etc.)
• Generates an SEO quality score
• Returns structured JSON output
• Supports multiple URLs per request

---

Tech Stack

• Platform: Apify Actor
• Language: (your implementation language)
• HTTP Client / Crawler: (e.g., Crawlee, Axios, Requests)
• HTML Parsing: (e.g., Cheerio, BeautifulSoup)

---

Input Format

The API accepts a JSON input with a list of website URLs.

Example input.json

{
  "startUrls": [
    {
      "url": "https://github.com/Gautamrana14"
    }
  ]
}

---

Usage

Base Endpoint (Apify Actor)

https://api.apify.com/v2/acts/<your-actor-id>/run-sync-get-dataset-items

Example Request (cURL)

curl -X POST \
  -H "Content-Type: application/json" \
  -d @input.json \
  "https://api.apify.com/v2/acts/<your-actor-id>/run-sync-get-dataset-items?token=YOUR_API_TOKEN"

Example using JavaScript

import fetch from "node-fetch";

const response = await fetch(
  "https://api.apify.com/v2/acts/<your-actor-id>/run-sync-get-dataset-items?token=YOUR_API_TOKEN",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      startUrls: [
        { url: "https://example.com" }
      ]
    })
  }
);

const data = await response.json();
console.log(data);

Example using Python

import requests

url = "https://api.apify.com/v2/acts/<your-actor-id>/run-sync-get-dataset-items"
params = {"token": "YOUR_API_TOKEN"}

payload = {
    "startUrls": [
        {"url": "https://example.com"}
    ]
}

response = requests.post(url, params=params, json=payload)
print(response.json())

---

Output Format

The API returns a dataset URL containing the analysis results.

Output Schema

{
  "dataset": "https://api.apify.com/v2/datasets/xxxx/items"
}

---

Dataset Schema

Each dataset item has the following structure:

{
  "url": "https://example.com",
  "titleText": "Example Page Title",
  "titleLength": 18,
  "metaDescription": "This is an example meta description for SEO analysis.",
  "metaDescriptionLength": 55,
  "issues": [
    "Meta description is too short"
  ],
  "seoScore": 82
}

Field Description

Field	Description
url	Website URL
titleText	Extracted page title
titleLength	Character length of the title
metaDescription	Extracted meta description
metaDescriptionLength	Character length of the meta description
issues	List of detected SEO issues
seoScore	SEO quality score (0–100)

---

Limitations

• Only checks title and meta description tags
• Does not analyze content, backlinks, or technical SEO
• Accuracy depends on page accessibility and HTML structure

---

Rate Limits

Depends on your Apify plan and actor configuration.

---

Roadmap

• Support for multiple pages per domain (site crawling)
• Keyword usage analysis
• SERP preview generation
• Title and description optimization suggestions
• Multi-language support

---

Contributing

Contributions are welcome.

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a pull request

---

License

MIT License

---

Author

Gautam Rana GitHub: https://github