Partner API Reference

Data Retention

We only keep data for 30 days. GET data before 30 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
600 Engine Redirect
601 Engine Service Unavailable
602 Engine Service Captcha Failed
603 Engine Over Limit
604 Engine Forbidden
699 Unknown Block
700 No Results for Keyword
800 Request Older than Time Limit (24 Hours for delayed / 1 Hour for priority)
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 Unavailable
909 Parsing Error
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
Google Maps: gmaps
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 Google Maps Locales & Parameters

lat
lng

See all supported Google Maps locale codes and descriptions at: http://api.authoritylabs.com/supported/gmaps.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)