Coswaa Tools REST API Documentation — Developer Reference

The Coswaa Tools REST API gives developers programmatic access to all active tools on the platform. You can list tools, search by category, retrieve individual tool metadata, and execute tools server-side from any application. All requests require an X-Coswaa-API-Key header — generate your key from WP Admin → Tools → Coswaa API.

Base URL

https://use.coswaa.com/wp-json/coswaa/v1

Authentication

Every request must include your API key as a header:

X-Coswaa-API-Key: capi_your_key_here

Endpoints

MethodEndpointDescription
GEThttps://use.coswaa.com/wp-json/coswaa/v1/statusPlugin health check and tool counts
GEThttps://use.coswaa.com/wp-json/coswaa/v1/toolsList all tools (filter by ?category=seo)
GEThttps://use.coswaa.com/wp-json/coswaa/v1/tools/{slug}Get metadata for a single tool
POSThttps://use.coswaa.com/wp-json/coswaa/v1/tools/{slug}/runExecute a tool — body: {“data”:{…}}

Example Request

curl -s -X POST 
  -H "X-Coswaa-API-Key: YOUR_KEY" 
  -H "Content-Type: application/json" 
  -d '{"data":{"text":"Hello world."}}' 
  "https://use.coswaa.com/wp-json/coswaa/v1/tools/word-counter/run"

Rate Limits

Each API key is limited to 60 requests per minute. Exceeding this limit returns an HTTP 429 response. Contact support to request a higher rate limit for production use.

Scroll to Top