Skip to main content

Base URL

All endpoints in this reference use the base URL: https://api.apifycloud.io/api/v1.

Authentication

Most endpoints require a Bearer token:
Authorization: Bearer {access_token}
Get a token using the OAuth client credentials flow in POST /oauth/token.

Response format

Successful responses follow this shape:
{
  "data": {},
  "meta": {
    "timestamp": "2024-01-01T00:00:00.000Z"
  },
  "pagination": {
    "limit": 25,
    "hasMore": false,
    "nextCursor": null
  }
}
pagination is only present on list endpoints that support cursor-based pagination. Errors follow this shape:
{
  "error": {
    "type": "validation_error",
    "message": "Invalid request parameters",
    "timestamp": "2024-01-01T00:00:00.000Z",
    "details": [
      {
        "field": "limit",
        "message": "Expected number, received string",
        "code": "invalid_type"
      }
    ]
  }
}