Random Agent from a Country (HTML)¶
Retrieve one agent at random from the given country. The result is an HTML file with the agent navigation interface.
- GET /country/(string: country_code)/random.html¶
Query Parameters: - country_code – an ISO 3166 country code
Request Headers: - Authorization – optional OAuth token to authenticate
Status Codes: - 200 OK – no error
Try it:
In this example, select one agent at random from Canada. The ISO 3166 country code for Canada is “ca” so that is added to the URL.
http://pplapi.com/country/ca/random.html
Example request:
GET /country/ca/random.html HTTP/1.1 Host: pplapi.com
Example response:
HTTP/1.1 200 OK Content-Type: text/html; charset=utf-8 Content-Length: 8295 <!DOCTYPE HTML> <html> <head> <title>pplapi - Agent #6,368,188,731</title> ...
