1ms.tools
APIsMCPSkillsPricing
REST · OpenAPI 3.1

SEO Checker API

Submit a URL for a page SEO audit and integrate title, description, structure and link checks into your reports and monitoring.

  • Successful results contain page-level SEO checks. They do not provide search ranking data or guarantee indexing or ranking improvements.
  • 1 credit per successful task
  • 10 external calls / minute / account
Get API keyTry API
Response preview

example.com

100/ 100 · Audit score
1 Passed0 Warnings0 Failed
Website

What is the SEO Checker API?

Submit a URL for a page SEO audit and integrate title, description, structure and link checks into your reports and monitoring.

Use cases

  • Pre-publish checks

    Check pages in a CMS publishing workflow to catch basic issues that can affect search indexing.

  • Recurring website audits

    Compare scores and issues across recurring website audits to prioritize fixes.

  • Client SEO reports

    Create SEO audit reports for client websites with issues and suggested improvements.

Playground

Send a live API request and inspect its job status and response.

Input
Loading…

Fill in the fields below. Switch to JSON only when you need to edit the raw request.

Source or generated URL.

Output
Run the API to see its response.

Reference

Replace the example key with one created in your console. The input demonstrates integration; consult the API documentation for all fields and validation rules. API docs

Request example
POST /openapi/v1/tools/1ms/seo-audit/execute
curl 'https://1ms.tools/openapi/v1/tools/1ms/seo-audit/execute' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: YOUR_UNIQUE_REQUEST_ID' \
  -d '{"url":"https://example.com"}'

JSON request parameters

FieldTypeRequiredDetected page description; may be null.
urlstringRequiredSource or generated URL.

Fields in data.result

FieldTypeDetected page description; may be null.
urlstringSource or generated URL.
finalUrlstringFinal URL after redirects.
summaryobjectStructured summary; missing upstream fields can be null.
checksarrayIndividual check statuses and recommendations.
suggestionsarraySuggested follow-up actions.
relatedToolsarrayRelated online tool slugs.

Response example

Illustrative contract example. Not a live lookup or captured registry record.
{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "JOB_ID",
    "status": "succeeded",
    "result": {
      "url": "https://example.com",
      "finalUrl": "https://example.com/",
      "summary": {
        "status": "healthy",
        "score": 100,
        "passed": 1,
        "warnings": 0,
        "failed": 0
      },
      "checks": [],
      "suggestions": [],
      "relatedTools": []
    },
    "error": null,
    "creditCost": 1,
    "creditsRefunded": false,
    "pollAfterMs": 6000,
    "statusUrl": "/openapi/v1/jobs/JOB_ID"
  }
}
Asynchronous response and result retrieval
Wait at least six seconds before polling with the same key. Read result on succeeded, or error on failed or canceled.
curl 'https://1ms.tools/openapi/v1/jobs/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Successful results contain page-level SEO checks. They do not provide search ranking data or guarantee indexing or ranking improvements.

Errors your code should handle

Job execution errors appear in data.error on a failed job. A successful status lookup can still return HTTP 200.

400Invalid input; no job or credit reservation.
401Missing, invalid, revoked or expired API key.
402Insufficient account credits; no job created.
404Resource unavailable or owned by another account.
409Idempotency conflict, or job cannot be canceled.
429Account rate limit reached. Wait for Retry-After.
500Submission interrupted. Retry with the original idempotency key.
Use SEO Checker API from your agent
Call the execute tool execute_1ms/seo_audit through the shared 1ms.tools MCP server or Agent Skill. Same API key and price: 1 credit per successful task.
MCP server Agent Skill

FAQ

Submit a URL for a page SEO audit and integrate title, description, structure and link checks into your reports and monitoring.

Successful results contain page-level SEO checks. They do not provide search ranking data or guarantee indexing or ranking improvements.

Yes. Connect the MCP server with an API key or browser OAuth authorization, or install the downloadable Agent Skill. These entries use asynchronous jobs and the same account credits and rate limit.

Use Authorization: Bearer YOUR_API_KEY or X-API-Key. External endpoints require a valid key; browser cookies cannot replace it. Keep keys on a server or in a trusted application environment.

Creating a job reserves 1 credit, finalized on success. Invalid input or insufficient credits creates no job and incurs no charge. Polling costs no credits but counts toward the rate limit.

If a job fails, times out on the server, or is canceled while queued, all reserved credits are automatically returned to your account. No request is needed. Successful jobs are charged normally. Only queued jobs can be canceled; closing the page or a client request timing out does not mean the job was canceled or failed. Check the final job status and creditsRefunded field, and view the refund in your credit history.

This endpoint uses asynchronous jobs, returning HTTP 202 and a job ID first. Poll the returned statusUrl and read result on success. Use Idempotency-Key for submission retries.

Each account can make 10 external business requests per calendar minute, shared by all keys and counted separately from web requests. Polling, uploads and execution all count; respect Retry-After on HTTP 429.