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:
Status Codes:

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.


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

        <title>pplapi - Agent #6,368,188,731</title>