1ms.tools
APIsMCPSkillsPricing
REST · OpenAPI 3.1

GEO Checker API

Check AI crawler access, content readability, structured data and citation readiness through an API with 27 GEO signals.

  • Results describe observable crawler and content signals; they do not guarantee citations by AI platforms. Consult the API documentation for checks and result fields.
  • 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 GEO Checker API?

Check AI crawler access, content readability, structured data and citation readiness through an API with 27 GEO signals.

Use cases

  • Website launch checks

    Check AI crawler access and content structure before launching a website.

  • Content change reviews

    Recheck readability and structured data signals after content or layout changes.

  • Content optimization reports

    Create GEO diagnostic reports so content teams can plan improvements across five dimensions.

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/geo-audit/execute
curl 'https://1ms.tools/openapi/v1/tools/1ms/geo-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.
generatedAtstringReport generation time.
summaryobjectStructured summary; missing upstream fields can be null.
sectionsarrayGEO dimensions, scores and checks.

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/",
      "generatedAt": "2026-10-14T00:00:00.000Z",
      "summary": {
        "score": 100,
        "grade": "A",
        "passed": 1,
        "warnings": 0,
        "failed": 0,
        "info": 0
      },
      "sections": []
    },
    "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'

Results describe observable crawler and content signals; they do not guarantee citations by AI platforms. Consult the API documentation for checks and result fields.

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 GEO Checker API from your agent
Call the execute tool execute_1ms/geo_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

Check AI crawler access, content readability, structured data and citation readiness through an API with 27 GEO signals.

Results describe observable crawler and content signals; they do not guarantee citations by AI platforms. Consult the API documentation for checks and result fields.

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.