Errors & Status Codes

SOCIOAPI uses standard HTTP status codes combined with uniform JSON error envelopes. When an error occurs, the success attribute is set to false and the error object provides specific diagnostic details.

HTTP Status Codes

200 OK

Request successfully processed. Data payload is attached in the response.

201 Created

New resource successfully created (e.g., crawling topics or webhook triggers).

400 Bad Request

Mandatory request parameters are missing, invalid, or malformed.

401 Unauthorized

API Key Bearer Token is missing, invalid, or expired.

403 Forbidden

Developer credit balance is depleted (0) or client IP is blocked.

404 Not Found

Requested endpoint URL path or target resource ID does not exist.

405 Method Not Allowed

HTTP method is not supported for the target endpoint (e.g., GET instead of POST).

413 Payload Too Large

Request body size exceeds the maximum permitted limit (> 5MB).

415 Unsupported Media Type

The Content-Type header must be application/json.

429 Too Many Requests

Request frequency quota exceeded (> 60 requests/minute).

Interactive Error Payload Inspector

Select a status code below to preview its complete JSON error response schema:

200 OK: Success Retrieve Data

Successful GET data retrieval response with pagination and metadata logs.

{
  "success": true,
  "status_code": 200,
  "message": "Success Retrieve Data..",
  "time": {
    "value": "15.845 ms",
    "setTimeBeforeActions": true
  },
  "meta_info": {
    "billing": {
      "plan_type": "CREDIT",
      "plan_name": "Starter",
      "remaining_credits": 10,
      "credits_charged": 5
    },
    "log": {
      "ip": "114.124.211.178"
    }
  },
  "data": [
    {
      "post_id": "3886838303705289135",
      "platform": "instagram",
      "caption": "Contoh konten postingan...",
      "engagement": 85
    }
  ],
  "pagination": {
    "total_items": 120,
    "total_pages": 12,
    "current_page": 1,
    "page_size": 10
  }
}