Introduction

The Sentrasa API gives you programmatic access to your workspace data. Use it to kick off scrape jobs, search posts, pull analytics, configure alerts, and export data — all from your own code or integrations.

Every API request is scoped to a workspace and authenticated with an API key. You get an API key from the dashboard under Settings > API Keys.

All API requests should be made to:

https://api.sentrasa.com/api/v1

Workspace-scoped endpoints follow the pattern:

https://api.sentrasa.com/api/v1/workspaces/{workspace_id}/...

You can find your workspace ID in the dashboard URL or via the Settings page.

1. Go to Settings > API Keys in the dashboard and create a key.

1. Make your first request:

curl https://api.sentrasa.com/api/v1/workspaces/{workspace_id}/posts \
  -H "X-API-Key: rp_your_api_key"

1. That's it — you'll get back your scraped posts as JSON.

The API uses standard HTTP status codes. Error responses include a JSON body with a detail field:

{
  "detail": "Not found"
}

Common status codes: 200 OK, 201 Created, 400 Bad Request, 401 Unauthorized (invalid or missing API key), 402 Payment Required (plan limit reached), 404 Not Found, 422 Validation Error, 429 Rate Limited, 500 Internal Server Error.

List endpoints support pagination. Most use limit and offset:

GET /api/v1/workspaces/{id}/jobs?limit=20&offset=40

The Posts endpoint uses cursor-based pagination for better performance:

GET /api/v1/workspaces/{id}/posts?limit=50&cursor=eyJpZCI6...

Responses include total, has_more, and (for posts) a cursor value to pass in the next request.