Partner API Reference

Data Retention


We only keep data for 7 days. GET data before 7 days or rePOST what you need.

Callback Error Codes


If you get a callback with a failed status there’s usually a valid reason why it failed. Use these status_codes to help us, help you figure out what happened.

200 Success
900 Bad Response
901 Bad Response
902 Bad Request Format
903 Engine Error
904 HTML Storage Error
905 JSON Storage Error
906 Locale Not Supported
907 Page Not Found
908 Locale Temporarily Unvailable
993 Unknown Engine Error
994 Unknown Processor Error
995 Unknown Responder Error
997 Network Error
998 Redirect Limit Error
999 Unrecognized Error

HTTP Status Codes


We use HTTP status codes to confirm the success, or failure of any method.  Currently, the following status codes are in use:

200 OK
201 Created
204 No Content
400 Bad request
401 Unauthorized
403 Forbidden
404 Not Found
410 Request Out of Date Range
500 Internal Server Error
503 Service Unavailable

Supported Format Types


json
html

Supported Engine Codes


Google: google
Yahoo: yahoo
Bing: bing
Yandex: yandex
Baidu: baidu

Supported Google Locales & Parameters


pages_from
lang_only
safe

See all supported Google locale codes and descriptions at: http://api.authoritylabs.com/supported/google.json (you don’t need an API key to view this)

Supported Yahoo! Locales & Parameters

lang_only
safe

See all supported Yahoo! locale codes and descriptions at: http://api.authoritylabs.com/supported/yahoo.json (you don’t need an API key to view this)

Supported Bing Locales & Parameters

lang_only
safe

See all supported Bing locale codes and descriptions at: http://api.authoritylabs.com/supported/bing.json (you don’t need an API key to view this)