Random Agent from a Country (TXT)

Retrieve one agent at random from the given country.

GET /country/(string: country_code)/random.txt
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.txt HTTP/1.1
Host: pplapi.com

Example response:

HTTP/1.1 200 OK
Content-Type: text/txt; charset=utf-8
Content-Length: 175

Agent #6,365,261,420 is a 58 year old
Female who currently lives in Canada.
This agent was born 1957-08-08, speaks
English, and does not have Internet
access.  The agent's religion is
Protestant.  This agent's yearly income
is $2539 USD. This Agent can be referred
to with the Alpha Identifier ygd-BMW.