Apify SEO Keyword Analyzer and Recommendations

An Apify Actor that performs SEO keyword analysis. It allows you to analyze keywords, retrieve content recommendations, and gain insights into competitors.

---

⚠️ Please note:

The output may take up to 2 minutes to process, depending on keyword complexity and competitor data volume. It does make a live analysis. Please be a patient. If you do not get a results in the output, write me an email to info@antonioblago.com

---

---

📌 Features

✅ Automated Query Submission → Submits keyword queries to SEO analysis.
✅ Retrieves Content Optimization Suggestions → Title terms, content terms & suggested questions.
✅ Competitor Insights → Extracts ranking competitor data for given keywords.
✅ Structured JSON Output → Provides easy-to-interpret results for analysis.
✅ Ideal for SEO Audits, Content Strategy & Keyword Research.

---

📊 Content Scoring Logic

Each competitor URL is assigned a Content Score, which reflects how well the page is optimized for the target keyword compared to other top-ranking pages.

The scoring is based on multiple content quality dimensions:

Component	Description	Weight (%)
Title Term Coverage	Measures how well important keyword-related terms appear in the page’s <title>.	20%
Content Term Coverage	Analyzes how frequently and naturally key terms occur throughout the page content.	35%
Keyword Spread & Density	Evaluates the distribution and placement of keywords across headings, paragraphs, and body.	15%
Semantic Relevance (NLP)	Uses natural language processing to assess how topically aligned the page is to the main keyword.	20%
Structure Quality	Considers formatting aspects like heading structure, paragraphs, and use of semantic HTML tags.	10%

---

Score Ranges Explained

Score Range	Interpretation
90–100	Highly optimized content with strong semantic and structural alignment.
70–89	Well-structured and relevant content with moderate optimization gaps.
<70	Low alignment to keyword intent, missing key terms or poor structure.

---

Why this Score Matters

This isn’t just about keyword stuffing — the score reflects how search-optimized, relevant, and semantically strong the content is.

The system uses competitive SERP data to determine which terms matter most, how they’re used by top-ranking pages, and how your content compares. It goes beyond exact matches and evaluates semantic context, keyword prominence, and topic completeness.

---

Example Output (with Score Breakdown)

{
  "competitors": [
    {
      "rank": 1,
      "url": "https://example.com",
      "content_score": 91,
      "score_breakdown": {
        "title": 18,
        "content_terms": 33,
        "spread_density": 12,
        "nlp_relevance": 18,
        "structure": 10
      }
    }
  ]
}

---

Let me know if you want this section embedded into your full Apify README in one go.

---

⚙️ Input Parameters

The actor accepts the following input in JSON format:

{
    "keyword": "seo check",
    "language": "English",
    "google_engine": "google.com"
}

Parameter	Type	Description
keyword	String	The target keyword for analysis (required).
language	String	Language for keyword analysis (default: English). Supported languages include English, Spanish, French, German, Chinese, Japanese, Italian, Dutch, Russian, and many more.
google_engine	String	Google search engine version (default: google.com). Supported versions include google.com, google.co.uk, google.ca, google.de, google.fr, google.es, google.it, google.nl, google.ru, google.co.in, google.com.br, and many more.

---

📤 Output Format

The actor returns structured JSON output with keyword analysis details.

1️⃣ Keyword Analysis Results

Example output:

{
    "query": "seo check",
    "metrics": {
        "word_count": { "target": 1200 }
    },
    "terms_txt": {
        "title": ["SEO", "check", "analysis"],
        "content_basic": ["SEO tips", "best practices"]
    },
    "competitors": [
        { "rank": 1, "url": "https://example.com", "content_score": 85 }
    ]
}

---

🚀 How to Run

Option 1: Using Apify Console

1. Go to the Apify Actor Page.
2. Click Run and provide the input JSON.
3. Retrieve results from the Dataset Storage.

Option 2: API Execution (cURL)

Run the actor directly via API:

cat > input.json <<'EOF'
{
    "keyword": "seo check",
    "language": "English",
    "google_engine": "google.com"
}
EOF

curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=$API_TOKEN" \
  -X POST \
  -d @input.json \
  -H 'Content-Type: application/json'

---

🔍 Example Use Cases

💡 SEO Audits → Get keyword insights and content term recommendations.
💡 Competitor Analysis → Identify top-ranking competitors and their strategies.
💡 Content Optimization → Improve keyword usage in articles for higher rankings.

---

📚 Resources

• Apify Docs
• Help
• SEO Support

---

🛠️ Author & Support

Developed by [Antonio Blago] 💬 Need help? Reach out via Apify Community

---