The Social API typically returns an HTTP status code of 400 Bad Request each time an error occurs. That means that, in addition to looking at the status code, you must look at the API response in order to know why the error occurred. The API response will look similar to this:

{
  "stat": "fail",
  "err": {
    "code": 1,
    "msg": "Invalid parameter: apiKey"
  }
}

The following table provides a brief description of the properties found in a typical error message:

Error message property

Description

stat

Status of the operation. Valid values are:

• OK
• Error
• Failed

code

Status code associated with the error. Note that this code isn't a standard HTTP status code. See the list of Social API error codes for more information.

msg

Additional information about the error and why it might have occurred.