Public service status

curl --request GET \
  --url https://socialquery.dev/v1/status

{
  "status": "operational",
  "platforms": {},
  "upstreamVersions": {},
  "updated_at": "2023-11-07T05:31:56Z",
  "route_version": "<string>",
  "observation_window_minutes": 30,
  "minimum_observations": 3,
  "circuit_breaker_observed": false,
  "coverage_note": "<string>"
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Service status

Public service status

Free passive status for every catalogued platform and non-operational operation. No API key, provider call or credit use. Missing adapters/credentials/routes are unavailable. Configured paths need at least three uncached successful or server-failed requests in the previous 30 minutes before operational status; 50%/90% failure shares yield degraded/down. Insufficient evidence is explicitly degraded, not evidence of an outage. Shared-method paths cannot be independently certified. Upstream API versions and circuit states are unknown. Responses can be cached for 30 seconds. GET only; no query parameters. The /v1/meta/status alias wraps the same data in the usual SocialQuery envelope.

GET

status

curl --request GET \
  --url https://socialquery.dev/v1/status

{
  "status": "operational",
  "platforms": {},
  "upstreamVersions": {},
  "updated_at": "2023-11-07T05:31:56Z",
  "route_version": "<string>",
  "observation_window_minutes": 30,
  "minimum_observations": 3,
  "circuit_breaker_observed": false,
  "coverage_note": "<string>"
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

{
  "success": false,
  "platform": "<string>",
  "endpoint": "<string>",
  "credits_used": 1,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": true,
  "error": {
    "code": "<string>",
    "type": "<string>",
    "message": "<string>",
    "status": 123,
    "doc_url": "<string>"
  }
}

Read service status without an API key or credits. This makes no provider calls. The response is bare JSON; /v1/meta/status wraps the same snapshot in the regular SocialQuery envelope for MCP and skill clients.

curl https://socialquery.dev/v1/status

Every platform is included. Its endpoints list contains non-operational operations and a reason:

Reason	Meaning
`route_unavailable`	No implemented, credentialed and policy-allowed route is configured.
`insufficient_recent_evidence`	Fewer than three uncached relevant requests occurred within 30 minutes. This is not proof of an outage.
`recent_failure_rate`	At least three observations exist and server failures reached 50% (degraded) or 90% (down).
`method_evidence_unavailable`	Logs aggregate a shared path without distinguishing HTTP methods. A successful GET cannot certify POST.

A configured path can be operational only with enough recent evidence and less than 50% server failures. Cache hits, caller validation/authentication errors and not-found responses are excluded. An entirely operational platform is operational; an entirely unavailable platform is down; mixed states are degraded. Overall status is operational only when all platforms are operational. This deliberately conservative snapshot is not active monitoring or an uptime guarantee. Trial exhaustion and upstream changes can still affect the next request. upstreamVersions is empty and circuit_breaker_observed is false because those observations are unavailable. updated_at records snapshot generation, not a provider update time. Shared storage and CDN caching can retain the response for 30 seconds. No account IDs, request IDs, input queries, credentials or request counts are published. Origin reads are limited to 60 per minute per IP. Invalid query parameters return 422; non-GET requests return 405; unavailable status storage returns 503 without claiming health. MCP: use get_service_status without credentials. Python skill: run socialquery_api.py status.

Response

Passive status snapshot; bare JSON rather than a charged-data envelope.

status

enum<string>

required

Available options:

operational,

degraded

platforms

object

required

Show child attributes

upstreamVersions

object

required

Empty: actual upstream version distribution is not recorded.

updated_at

string<date-time>

required

route_version

string

required

observation_window_minutes

integer

required

minimum_observations

integer

required

circuit_breaker_observed

boolean

required

coverage_note

string

required