On-Page SEO Analysis API

Developers building modern web applications, content management systems, or CI/CD pipelines often face a common challenge: integrating robust SEO analysis directly into their workflows. Manual audits are time-consuming and prone to human error, making programmatic solutions essential. ToolYour offers a powerful on-page SEO analysis API designed for these exact needs, enabling you to automate insights, enforce best practices, and enhance user experience directly within your software products.

This guide explores how ToolYour's REST-first API, alongside its Model Context Protocol (MCP) capabilities, empowers developers to embed sophisticated on-page SEO checks effortlessly. We'll cover the core features, how to get started, and critical details about API keys and usage limits.

On-page SEO in Software Products

Modern software development demands integration. For any product or service touching web content, on-page SEO is a non-negotiable aspect of quality and discoverability. Developers frequently need to:

• Integrate real-time SEO feedback: Imagine a content editor receiving instant suggestions for title tag length, meta description optimization, or keyword density as they write, directly within their CMS.
• Automate pre-deployment checks: Before a new page goes live, a CI/CD pipeline can automatically run an on-page SEO audit, flagging issues and preventing them from reaching production.
• Build custom SEO dashboards: Agencies or in-house teams can create tailored dashboards that monitor the on-page health of thousands of pages, identifying trends and critical issues at scale.
• Enhance internal tools: Develop internal tools that analyze competitor pages, monitor existing content, or generate SEO-friendly content outlines based on specific keywords.

Manually performing these tasks for a large number of pages is inefficient and impractical. This is where a dedicated on-page SEO analysis API becomes invaluable. It provides a structured, scalable way to access detailed on-page metrics and recommendations programmatically, transforming what was once a manual chore into an automated, integrated process.

What ToolYour Exposes via REST

ToolYour provides a comprehensive catalog of over 200 digital tools, accessible through various surfaces including a free browser experience, a robust REST API, and Model Context Protocol (MCP) for agent integration. Our REST API is designed for direct, explicit programmatic control, allowing developers to integrate specific functionalities like on-page SEO analysis directly into their applications.

The on-page SEO analysis API is part of ToolYour's SEO and site tools category. It allows you to submit a URL and receive a structured analysis of its on-page elements. While specific endpoint details and available metrics are fully documented in our developer portal, the API typically provides insights into critical factors that influence a page's search engine visibility. This can include assessments related to:

• Title and Meta Description: Length, presence, and relevance.
• Headings Structure: H1, H2, H3 usage and content.
• Keyword Presence: Analysis of keyword usage in content and specific HTML tags.
• Content Readability: Evaluation of text complexity and flow.
• Image Optimization: Checks for alt attributes and image sizes.
• Internal and External Links: Quantity and quality of links.
• Canonical Tags: Correct implementation to prevent duplicate content issues.
• Schema Markup: Detection of structured data.

By exposing these insights through a standardized REST API, ToolYour enables developers to not just fetch data, but to act on it. You can build automated reports, trigger alerts, or even feed the data into AI models for content generation and optimization.

For a hands-on look at some of the on-page SEO capabilities in a browser, you can explore the ToolYour SEO Audit tool. This browser-based tool offers a user-friendly interface to perform a quick audit, showcasing the type of data available programmatically.

API Keys and Limits

Accessing any of ToolYour's programmatic features, including the on-page SEO analysis API, requires an API key. This key authenticates your requests and associates them with your account's usage quota.

How to obtain an API key:

1. Sign up for a free ToolYour account at https://www.toolyour.com/signup.
2. Navigate to your dashboard and select the API Keys section: https://www.toolyour.com/dashboard/api-keys.
3. Generate a new API key. All ToolYour API keys are prefixed with ty_.

Usage Quota and Limits: ToolYour operates on a transparent usage model, ensuring you have clear expectations for your API consumption.

• Free Plan: The free plan includes 500 successful requests per month.
• Throughput Limit: In addition to the monthly allowance, the free plan has a rate limit of 5 successful requests per minute.
• Quota Resets: Your monthly quota automatically resets on the 1st of each calendar month.
• Shared Quota: All API keys associated with your account share the same monthly quota. This applies universally across both REST API calls and any tools run via MCP agents.
• Successful Requests Only: Generally, only successful tool calls count towards your quota. Invalid requests that fail due to malformed input or authentication issues typically do not consume your allowance.
• No Overage Charges: ToolYour does not charge for overages. If you reach your plan's request limit, further requests will be blocked until your quota resets or you upgrade your plan.

For comprehensive details on managing your API keys and understanding usage, refer to the Account and Keys documentation and Usage and Plans documentation in the ToolYour Developer Portal.

REST vs MCP for SEO Jobs

ToolYour offers two primary programmatic interfaces for executing tasks, including on-page SEO analysis API calls: the traditional REST API and the Model Context Protocol (MCP) for agent-based workflows. Understanding the distinction helps you choose the right approach for your project.

REST API: Direct Control and Predictable Execution

The REST API is your go-to for direct, explicit, and highly predictable tool invocation. When you make a REST API call, you specify the exact tool you want to use (e.g., the on-page SEO analysis API), provide its required parameters, and receive a structured response.

• Pros:
  • High Control: You dictate every aspect of the request, ensuring the precise tool and parameters are used.
  • Predictable: Ideal for integration into existing codebases, CI/CD pipelines, or situations requiring specific tool guarantees.
  • Mature and Stable: A widely adopted standard for API interactions, offering robust error handling and well-defined interfaces.
• Best for:
  • Adding on-page SEO checks to a pre-commit hook.
  • Building a custom content scoring system in a CMS.
  • Integrating SEO analysis into a data pipeline that processes new web pages.

MCP: Agent-Driven Workflows and Flexible Goals

The Model Context Protocol (MCP) is a communication standard that allows large language models (LLMs) like those from Cursor or Claude to interact with external tools and APIs. ToolYour's MCP integration means you can expose a subset of its API-backed tools, including SEO analysis capabilities, to agents. Instead of calling a specific tool directly, you describe a high-level goal, and the agent, using MCP, determines which ToolYour tool(s) to invoke.

• How it works: An agent receives a solve_task goal (e.g., "Analyze the on-page SEO for https://yoursite.com/new-product-page and suggest improvements"). The agent then uses discover_tools to find relevant ToolYour tools, get_tool_schema to understand their parameters, and invoke_tool to execute them.
• Early Phase: It's important to note that ToolYour's solve_task capability via MCP is in an early phase. While agents are improving rapidly, their routing, workflow execution, and tool coverage are regularly upgraded. You might frequently encounter a status: suggest response, where the agent suggests a tool and parameters but requires human confirmation or a direct invoke_tool call.
• Production Critical Flows: For production-critical applications requiring guaranteed tool execution, the recommended approach is to directly use discover_tools to find the tool, get_tool_schema to understand its input, and then invoke_tool with explicit parameters. This provides greater control and reliability than relying solely on solve_task in its current early phase.
• Quota Usage: Running a tool through MCP consumes your monthly quota in the same way a direct REST API call does. Browsing the tool catalog via MCP, however, does not count towards your quota.

For a deeper dive into integrating with ToolYour via MCP, including client setup and example solve_task requests, visit the Model Context Protocol documentation.

Choosing Your Approach:

• Use REST API for explicit, controlled integrations where you know exactly which ToolYour tool you need and its parameters.
• Consider MCP when building agentic applications where you want the LLM to dynamically select and use tools based on high-level goals, keeping in mind its current early phase for solve_task. For robust production use with MCP, prioritize discover_tools and invoke_tool.

Getting Started

Integrating the on-page SEO analysis API into your application is a straightforward process. Here's a quick guide to help you make your first programmatic request.

Prerequisites

1. ToolYour Account: If you don't have one, sign up for free at https://www.toolyour.com/signup.

2. API Key: Generate your API key from your dashboard. Remember, your key will start with ty_.

Making Your First REST API Call

All ToolYour REST API requests require your API key to be sent in the X-Api-Key HTTP header.

Let's assume there's a specific endpoint for on-page SEO analysis. While we cannot invent the exact endpoint path, the structure of a curl request will look similar to this:

curl -X POST \
  https://api.toolyour.com/api/v1/seo/on-page-analysis \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: ty_YOUR_API_KEY_HERE' \
  -d '{
    "url": "https://yoursite.com/example-product-page",
    "language": "en"
  }'

Replace ty_YOUR_API_KEY_HERE with your actual API key. The url parameter should be the target page you wish to analyze. The specific parameters will vary based on the exact tool, which you can find in the official documentation.

Understanding the Response: The API will return a JSON object containing the on-page SEO analysis results. This might include:

{
  "status": "success",
  "data": {
    "url": "https://yoursite.com/example-product-page",
    "analysisResults": {
      "title": {
        "value": "Example Product Page - ToolYour",
        "length": 30,
        "recommendation": "Good"
      },
      "metaDescription": {
        "value": "Discover how ToolYour can enhance your digital presence.",
        "length": 60,
        "recommendation": "Needs improvement: target 150-160 characters."
      },
      "h1Count": 1,
      "keywordDensity": {
        "toolyour": "2.5%",
        "api": "1.2%"
      }
      // ... more structured SEO data
    }
  }
}

This structured output allows your application to parse the data, display it to users, trigger further actions, or store it for historical tracking.

Exploring the Documentation

For detailed information on all available tools, specific endpoint paths, required parameters, and example responses, consult the ToolYour Developer Documentation. This resource is your primary reference for integrating any ToolYour API functionality. You'll find sections dedicated to:

• Quickstart guides
• Calling tools
• Handling errors

By following these steps, you can quickly begin leveraging ToolYour's on-page SEO analysis API to empower your applications with automated, intelligent SEO capabilities.

FAQ

Here are answers to common questions about using ToolYour's on-page SEO analysis API and platform.

Q: What is the ToolYour API key prefix?

A: All ToolYour API keys are prefixed with ty_. For example: ty_YOUR_UNIQUE_KEY.

Q: How many free requests do I get per month?

A: The free plan includes 500 successful requests per month, shared across all API keys on your account and applicable to both REST and MCP tool calls.

Q: Is there a rate limit on the free plan?

A: Yes, the free plan also has a throughput limit of 5 successful requests per minute.

Q: When does my monthly request quota reset?

A: Your monthly quota resets on the 1st of each calendar month.

Q: Do invalid API requests count against my quota?

A: Generally, invalid requests that do not successfully invoke a tool do not count against your monthly quota. Only successful tool calls consume your allowance.

Q: Can I use the same API key for both REST and MCP integrations?

A: Yes, your API key is universal. It authenticates requests for both the REST API and for tools invoked via Model Context Protocol (MCP) agents, and the usage is counted against the same shared monthly quota.

Q: If I hit my request limit, what happens?

A: If you reach your plan's request limit, further requests will be blocked. To continue using the API, you would need to upgrade your plan or wait until your quota resets on the 1st of the next calendar month. ToolYour does not have pay-as-you-go overage billing.

Q: Is solve_task via MCP ready for production?

A: The solve_task capability within ToolYour's MCP integration is in an early phase. While it's powerful for agentic exploration, for production-critical flows requiring guaranteed execution, we recommend using discover_tools and invoke_tool directly to ensure explicit control over tool selection and parameters. Agents using solve_task may often return a status: suggest for recommended actions.

Conclusion

The ability to programmatically perform on-page SEO analysis is a game-changer for developers. ToolYour's on-page SEO analysis API provides a robust, developer-friendly solution to embed critical SEO insights directly into your applications, CI/CD pipelines, and internal tools. By leveraging our REST API, you gain fine-grained control over detailed on-page evaluations, enabling automation that saves time, reduces errors, and improves the overall quality and discoverability of web content.

Whether you're enhancing a content management system, building custom SEO dashboards, or integrating with agent-based workflows via MCP, ToolYour provides the flexible tooling you need. The platform's clear usage limits, shared quota, and commitment to a REST-first approach ensure a smooth integration experience.

Ready to automate your on-page SEO analysis?

• Get started: Sign up for a free ToolYour account at https://www.toolyour.com/signup.
• Generate an API key: Visit your API Keys dashboard.
• Explore the documentation: Dive into the full capabilities of the ToolYour API at https://www.toolyour.com/developers/docs.
• Learn about MCP: Understand agent-based integrations at https://www.toolyour.com/developers/mcp.