SEO Tools
SEO analysis and data APIs — REST, TypeScript SDK, and MCP.
TypeScript SDK
Namespace: ty.seo. Full table: SDK Tool Map → SEO Tools / SEO APIs.
import { ToolYour } from "@toolyour/sdk";
const ty = ToolYour({ apiKey: process.env.TOOLYOUR_API_KEY! });
await ty.seo.seoAnalyze({ url: "https://example.com" });
await ty.seo.metaTagsAnalyzer({ url: "https://example.com" });
await ty.seo.competitorPageCompare({
yourUrl: "https://yoursite.com/page",
competitorUrl: "https://competitor.com/page",
});
await ty.seo.metaTagsAnalyzer(
{ url: "https://example.com" },
{ format: "markdown" }
);SEO Tools (POST)
Base path: /api/v1/seo-tools
| Endpoint | Description |
|---|---|
POST /analyze | SEO analysis for a URL (JSON body) |
POST /compare | Compare two URLs (JSON body) |
curl -X POST "https://api.toolyour.com/api/v1/seo-tools/analyze" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $API_KEY" \
-d '{"url":"https://example.com"}'SEO APIs (GET)
Base path: /api/v1/seo-apis
All require url query parameter and X-Api-Key:
curl -G "https://api.toolyour.com/api/v1/seo-apis/page-speed-analyzer" \
-H "X-Api-Key: $API_KEY" \
--data-urlencode "url=https://example.com"| Path | Tool |
|---|---|
/rank-checker/keywords | Keyword rank data |
/page-speed-analyzer | Page speed (proxy CWV + evidence.assetOptimizer compress/defer/preload hints) |
/link-extractor | Extract links |
/content-optimization | Content suggestions |
/internal-linking | Internal links |
/social-media-integration | Social tags |
/meta-tags-analyzer | Meta tags |
/robots-txt-checker | Robots.txt |
/sitemap-xml-validator | Sitemap XML |
/canonical-url-checker | Canonical URL |
/http-status-checker | HTTP status |
/redirect-chain-analyzer | Redirect chains |
/broken-link-checker | Broken links |
/mixed-content-checker | Mixed content |
/schema-markup-validator | Schema markup (JSON-LD) |
/serp-snippet-preview | SERP snippet preview |
/heading-structure-analyzer | Heading structure |
/image-alt-text-checker | Image alt text |
/competitor-page-compare | Competitor page compare (POST JSON) |
/hreflang-checker | Hreflang alternate links |
/llms-txt-builder | Deterministic llms.txt stub (no LLM) |
/llms-txt-validator | Parse / validate origin llms.txt |
/ai-overview-readiness-checker | Structural GEO readiness score |
/seo-change-diff | Field-level SEO diff (POST JSON) |
/duplicate-content-checker | Duplicate / similarity check (POST JSON) |
/bulk-url-seo-auditor | Bulk lite scorecard (POST JSON; plan-capped) |
competitor-page-compare is POST with JSON body { "yourUrl", "competitorUrl" }:
curl -X POST "https://api.toolyour.com/api/v1/seo-apis/competitor-page-compare" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $API_KEY" \
-d '{"yourUrl":"https://yoursite.com/page","competitorUrl":"https://competitor.com/page"}'seo-change-diff is POST with JSON body { "urlA", "urlB" }:
curl -X POST "https://api.toolyour.com/api/v1/seo-apis/seo-change-diff" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $API_KEY" \
-d '{"urlA":"https://example.com/before","urlB":"https://example.com/after"}'duplicate-content-checker is POST with either { "urlA", "urlB" } or { "textA", "textB" }:
curl -X POST "https://api.toolyour.com/api/v1/seo-apis/duplicate-content-checker" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $API_KEY" \
-d '{"urlA":"https://example.com/page-a","urlB":"https://example.com/page-b"}'bulk-url-seo-auditor is POST with { "urls": ["https://…"] } and/or { "urlsText": "…" } (newline/comma-separated). Free plans cap at 5 URLs; paid at 20:
curl -X POST "https://api.toolyour.com/api/v1/seo-apis/bulk-url-seo-auditor" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $API_KEY" \
-d '{"urls":["https://example.com/","https://example.com/about"]}'All Batch 3 SEO tools are deterministic (fetch/parse/heuristics only — no generative AI). The bulk auditor is the same class of tool (lite scorecard only — not a full crawl).
Shared report export mode
Any SEO APIs response can be exported without a separate catalog tool:
format query | Response |
|---|---|
| (omit) | Standard JSON envelope (status, result with toolResult@1) |
markdown | text/markdown brief: score, metrics, findings, recommendations |
json | Pretty-printed toolResult JSON (no envelope) |
curl -G "https://api.toolyour.com/api/v1/seo-apis/meta-tags-analyzer" \
-H "X-Api-Key: $API_KEY" \
--data-urlencode "url=https://example.com" \
--data-urlencode "format=markdown"Browser tool reports also include Copy Markdown / Copy JSON / download controls.
rank-checker/keywords accepts optional keyword for focus-keyword placement scoring. content-optimization includes classical readability formulas (Flesch, SMOG, ARI).
See SEO Tools and SEO APIs tags in the API reference.