String docs
Site integrations

TruePeopleSearch

TruePeopleSearch people search and person records: find people by name and city or state, then read the anonymous record — exact age and birth month/year, wireless and landline numbers with carrier and last-reported date, email addresses, current and previous addresses, possible relatives and associates, and alternate names.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: truepeoplesearch
  • Version: 1.0.0
  • Reads from: www.truepeoplesearch.com
ActionDescriptionListed price
searchSearch TruePeopleSearch for people by name, narrowed by city and state, and get each candidate's person id, exact age, current city and state, prior locations and the first relatives' names, plus the page's total records-found count. The page shows about ten cards even when it reports far more records, so a large total with tooManyToDisplay means the name needs a tighter place. Pass a candidate's id to the person action for the full record.Billed per request at your plan's rates
personRead TruePeopleSearch person records: the exact age and birth month/year, every wireless and landline number with carrier and last-reported date (the possible primary phone flagged), every email address, the current and previous addresses with reported dates and county, possible relatives and associates each with their own person id, and alternate names. Up to 25 people per call; search returns the ids.Billed per request at your plan's rates

Search TruePeopleSearch for people by name, narrowed by city and state, and get each candidate's person id, exact age, current city and state, prior locations and the first relatives' names, plus the page's total records-found count. The page shows about ten cards even when it reports far more records, so a large total with tooManyToDisplay means the name needs a tighter place. Pass a candidate's id to the person action for the full record.

POST https://request.usestring.ai/v1/integrations/truepeoplesearch/search

Input

Unknown fields are rejected.

FieldTypeDescription
namestringRequired. The person's name, such as Johnny Bledsoe. At least 1 character.
citystringThe city to search in, such as Lexington; optional.
statestringThe two-letter state, such as KY, or a state name; optional.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
positionintegerThe person's place on the results page, from 1.
idstringThe TruePeopleSearch person id, which the person action takes.
namestring—
ageinteger | nullThe person's exact age.
citystring | nullThe city the person lives in.
statestring | nullThe state the person lives in.
priorLocationsstring[]Places the card lists under Used to live in; the last may be cut off, see priorLocationsTruncated.
moreLocationsbooleanTrue when the card abbreviates the prior-location list with an ellipsis.
relativesstring[]Names the card lists under Related to; the last may be cut off, see moreRelatives.
moreRelativesbooleanTrue when the card abbreviates the relatives list with an ellipsis.
urlstringThe person's detail page.
totalResultsinteger | nullThe records-found count the page reports for the whole search, which is larger than the cards it shows.
tooManyToDisplaybooleanTrue when the page warns Too many records, please filter by age range, meaning the cards are a top slice of a much larger answer.

Example

curl https://request.usestring.ai/v1/integrations/truepeoplesearch/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Johnny Bledsoe",
    "city": "Lexington",
    "state": "KY"
  }'

data starts with these rows:

[
  {
    "position": 1,
    "id": "prllu9unnru4n99408u4",
    "name": "Johnny Bledsoe",
    "age": 66,
    "city": "Florissant",
    "state": "MO",
    "priorLocations": ["Lexington, KY", "Glen Carbon IL"],
    "moreLocations": true,
    "relatives": ["Antonio Fane", "Dominique Fane", "Edna Fane"],
    "moreRelatives": true,
    "url": "https://www.truepeoplesearch.com/find/person/prllu9unnru4n99408u4",
    "totalResults": 10,
    "tooManyToDisplay": false
  },
  {
    "position": 2,
    "id": "p66r09l89l926694n869",
    "name": "Johnny Bledsoe",
    "age": 61,
    "city": "Winchester",
    "state": "KY",
    "priorLocations": ["Lexington, KY", "Richmond KY", "Louisa KY"],
    "moreLocations": true,
    "relatives": ["Dana Bledsoe", "Dallas Bledsoe"],
    "moreRelatives": true,
    "url": "https://www.truepeoplesearch.com/find/person/p66r09l89l926694n869",
    "totalResults": 10,
    "tooManyToDisplay": false
  },
  {
    "position": 3,
    "id": "px8n9nn4lu8u04l9uu408",
    "name": "Johnny Bledsoe",
    "age": 59,
    "city": "Richmond",
    "state": "KY",
    "priorLocations": ["Lexington, KY", "Louisa KY"],
    "moreLocations": true,
    "relatives": ["Johnny Bledsoe", "Dallas Bledsoe"],
    "moreRelatives": true,
    "url": "https://www.truepeoplesearch.com/find/person/px8n9nn4lu8u04l9uu408",
    "totalResults": 10,
    "tooManyToDisplay": false
  }
]

Requests and billing

  • Requests: 1–3 Web Access requests per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

person

Read TruePeopleSearch person records: the exact age and birth month/year, every wireless and landline number with carrier and last-reported date (the possible primary phone flagged), every email address, the current and previous addresses with reported dates and county, possible relatives and associates each with their own person id, and alternate names. Up to 25 people per call; search returns the ids.

POST https://request.usestring.ai/v1/integrations/truepeoplesearch/person

Input

Unknown fields are rejected.

FieldTypeDescription
itemsstring[]Required. TruePeopleSearch person ids, such as plnnr28l44r66989l2u, or /find/person/<id> URLs. 1 to 25 entries.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
idstringThe TruePeopleSearch person id.
urlstringThe detail page.
namestring—
firstNamestring | null—
lastNamestring | null—
ageinteger | nullThe exact age the record reports.
birthMonthstring | nullThe month the record gives under Born, such as August.
birthYearinteger | nullThe year the record gives under Born, such as 1975.
citystring | nullThe city the record says the person lives in.
statestring | nullThe state the record says the person lives in.
primaryPhonestring | nullThe number the header shows under the summary.
alsoKnownAsstring[]Every other name the record lists under Also Seen As.
currentAddressobject | null—
currentAddress.addressstringThe street line, such as 2375 Chauvin Dr #C.
currentAddress.citystring | null—
currentAddress.statestring | null—
currentAddress.zipstring | null—
currentAddress.countystring | null—
currentAddress.fromDatestring | nullWhen the person was first reported here, such as Nov 1994.
currentAddress.toDatestring | nullWhen the person was last reported here, such as Nov 2026.
currentAddress.urlstringThe address's lookup page.
previousAddressesobject[]Every previous address, with its county and reported dates.
previousAddresses[].addressstringThe street line, such as 2375 Chauvin Dr #C.
previousAddresses[].citystring | null—
previousAddresses[].statestring | null—
previousAddresses[].zipstring | null—
previousAddresses[].countystring | null—
previousAddresses[].fromDatestring | nullWhen the person was first reported here, such as Nov 1994.
previousAddresses[].toDatestring | nullWhen the person was last reported here, such as Nov 2026.
previousAddresses[].urlstringThe address's lookup page.
phonesobject[]Every phone number, landline and wireless, with carrier and last-reported date.
phones[].numberstringThe number as the page shows it, such as (925) 489-8174.
phones[].lineTypestring | nullWireless or Landline.
phones[].carrierstring | nullThe carrier the record names, such as T-Mobile.
phones[].lastReportedstring | nullWhen the record last saw the number, such as Sep 2026.
phones[].primarybooleanTrue when the record flags it Possible Primary Phone.
phones[].inactivebooleanTrue when the record marks the number Inactive.
emailsstring[]Every email address the record shows, in clear text.
relativesobject[]Possible relatives, each linked to their own record.
relatives[].namestring—
relatives[].ageinteger | null—
relatives[].idstringThe person's TruePeopleSearch id, which the person action takes.
relatives[].urlstringThe person's detail page.
associatesobject[]Possible associates, each linked to their own record.
associates[].namestring—
associates[].ageinteger | null—
associates[].idstringThe person's TruePeopleSearch id, which the person action takes.
associates[].urlstringThe person's detail page.

Example

curl https://request.usestring.ai/v1/integrations/truepeoplesearch/person \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": ["p28l9n9l622460l289n"]
  }'

data starts with these rows:

[
  {
    "id": "p28l9n9l622460l289n",
    "url": "https://www.truepeoplesearch.com/find/person/p28l9n9l622460l289n",
    "name": "Chris Miller",
    "firstName": "Chris",
    "lastName": "Miller",
    "age": 41,
    "birthMonth": "September",
    "birthYear": 1985,
    "city": "Monroe",
    "state": "NY",
    "primaryPhone": "(845) 238-2952",
    "alsoKnownAs": ["Christopher Joseph Miller", "Christoper Miller", "Christophe Miller", "Christopher Smith"],
    "currentAddress": {
      "address": "907 Swan Hollow Rd",
      "city": "Monroe",
      "state": "NY",
      "zip": "10950",
      "county": "Orange County",
      "fromDate": "Nov 2017",
      "toDate": "Nov 2026",
      "url": "https://www.truepeoplesearch.com/find/address/907-swan-hollow-rd_monroe-ny-10950"
    },
    "previousAddresses": [
      {
        "address": "33 Glenmere Rd",
        "city": "Chester",
        "state": "NY",
        "zip": "10918",
        "county": "Orange County",
        "fromDate": "Dec 2001",
        "toDate": "Apr 2013",
        "url": "https://www.truepeoplesearch.com/find/address/33-glenmere-rd_chester-ny-10918"
      },
      {
        "address": "1307 Helias St NW",
        "city": "Palm Bay",
        "state": "FL",
        "zip": "32907",
        "county": "Brevard County",
        "fromDate": "Jun 2010",
        "toDate": "Jun 2012",
        "url": "https://www.truepeoplesearch.com/find/address/1307-helias-st-nw_palm-bay-fl-32907"
      },
      {
        "address": "229 N Main St",
        "city": "Monroe",
        "state": "NY",
        "zip": "10950",
        "county": "Orange County",
        "fromDate": "Feb 2009",
        "toDate": "Apr 2010",
        "url": "https://www.truepeoplesearch.com/find/address/229-n-main-st_monroe-ny-10950"
      },
      {
        "address": "13 Ridge Rd",
        "city": "Monroe",
        "state": "NY",
        "zip": "10950",
        "county": "Orange County",
        "fromDate": "Feb 2008",
        "toDate": "Jul 2008",
        "url": "https://www.truepeoplesearch.com/find/address/13-ridge-rd_monroe-ny-10950"
      },
      {
        "address": "23 Tephanic Ave",
        "city": "Monroe",
        "state": "NY",
        "zip": "10950",
        "county": "Orange County",
        "fromDate": "Dec 2001",
        "toDate": "Jan 2002",
        "url": "https://www.truepeoplesearch.com/find/address/23-tephanic-ave_monroe-ny-10950"
      }
    ],
    "phones": [
      {
        "number": "(845) 238-2952",
        "lineType": "Landline",
        "carrier": "CSC Voice",
        "lastReported": "Oct 2026",
        "primary": true,
        "inactive": false
      }
    ],
    "emails": ["[email protected]", "[email protected]", "[email protected]", "[email protected]", "[email protected]", "[email protected]", "[email protected]", "[email protected]", "[email protected]"],
    "relatives": [
      {
        "name": "Chris Miller",
        "age": 78,
        "id": "pxnurr2699640906un282",
        "url": "https://www.truepeoplesearch.com/find/person/pxnurr2699640906un282"
      },
      {
        "name": "Johnny Bledsoe",
        "age": 51,
        "id": "plnnr28l44r66989l2u",
        "url": "https://www.truepeoplesearch.com/find/person/plnnr28l44r66989l2u"
      },
      {
        "name": "Kristen Cirigliano",
        "age": 56,
        "id": "pl9nurr499u0068r0n4r",
        "url": "https://www.truepeoplesearch.com/find/person/pl9nurr499u0068r0n4r"
      },
      {
        "name": "Lori Miller",
        "age": 65,
        "id": "p46url28l46660lnn686",
        "url": "https://www.truepeoplesearch.com/find/person/p46url28l46660lnn686"
      },
      {
        "name": "Richard Miller 3rd",
        "age": 45,
        "id": "pxr6892n406066lrr0006",
        "url": "https://www.truepeoplesearch.com/find/person/pxr6892n406066lrr0006"
      },
      {
        "name": "Ann Miller",
        "age": 89,
        "id": "p986lulu440n4u26nr4",
        "url": "https://www.truepeoplesearch.com/find/person/p986lulu440n4u26nr4"
      },
      {
        "name": "Arthur Miller",
        "age": 97,
        "id": "pxr02nn429n869r64099r",
        "url": "https://www.truepeoplesearch.com/find/person/pxr02nn429n869r64099r"
      },
      {
        "name": "Ashley Miller",
        "age": 46,
        "id": "pn0n049880rlr29806n0",
        "url": "https://www.truepeoplesearch.com/find/person/pn0n049880rlr29806n0"
      },
      {
        "name": "Brien Miller",
        "age": 68,
        "id": "px8r8ullnl6602u00n092",
        "url": "https://www.truepeoplesearch.com/find/person/px8r8ullnl6602u00n092"
      },
      {
        "name": "Bruce Miller",
        "age": 54,
        "id": "pl66u884rrlr4l46u848",
        "url": "https://www.truepeoplesearch.com/find/person/pl66u884rrlr4l46u848"
      },
      {
        "name": "Caitlin Miller",
        "age": 37,
        "id": "p24ru88r6r42ulrl666l",
        "url": "https://www.truepeoplesearch.com/find/person/p24ru88r6r42ulrl666l"
      },
      {
        "name": "Catherine Miller",
        "age": 42,
        "id": "pxl8rr9u4008rr2846l08",
        "url": "https://www.truepeoplesearch.com/find/person/pxl8rr9u4008rr2846l08"
      },
      {
        "name": "Charles Miller",
        "age": 72,
        "id": "px8n0ln9lrn0l46u22924",
        "url": "https://www.truepeoplesearch.com/find/person/px8n0ln9lrn0l46u22924"
      },
      {
        "name": "Dawn Miller",
        "age": 67,
        "id": "p848066r6u02ln4u68rn",
        "url": "https://www.truepeoplesearch.com/find/person/p848066r6u02ln4u68rn"
      },
      {
        "name": "Gregory Miller",
        "age": 68,
        "id": "p4nu98228200l24n22l2",
        "url": "https://www.truepeoplesearch.com/find/person/p4nu98228200l24n22l2"
      },
      {
        "name": "Jean Miller",
        "age": 97,
        "id": "pn4urr6u262u0480u802",
        "url": "https://www.truepeoplesearch.com/find/person/pn4urr6u262u0480u802"
      },
      {
        "name": "Julia Miller",
        "age": 60,
        "id": "px20un8u269062600n4r6",
        "url": "https://www.truepeoplesearch.com/find/person/px20un8u269062600n4r6"
      },
      {
        "name": "Lori Miller",
        "age": 66,
        "id": "pl6r06u8u89nurn2u6l8",
        "url": "https://www.truepeoplesearch.com/find/person/pl6r06u8u89nurn2u6l8"
      },
      {
        "name": "Mikaela Miller",
        "age": 29,
        "id": "purl92648rll92982l44",
        "url": "https://www.truepeoplesearch.com/find/person/purl92648rll92982l44"
      },
      {
        "name": "Ralph Miller",
        "age": 75,
        "id": "pxlrru4un42000rur9982",
        "url": "https://www.truepeoplesearch.com/find/person/pxlrru4un42000rur9982"
      },
      {
        "name": "Ralph Miller Sr",
        "age": 96,
        "id": "px6uu6u0l44r2ul499946",
        "url": "https://www.truepeoplesearch.com/find/person/px6uu6u0l44r2ul499946"
      },
      {
        "name": "Richard Miller",
        "age": 76,
        "id": "px6u660289n6n999n9982",
        "url": "https://www.truepeoplesearch.com/find/person/px6u660289n6n999n9982"
      },
      {
        "name": "Richard Miller",
        "age": 86,
        "id": "px24l0688496r9r29n8ln",
        "url": "https://www.truepeoplesearch.com/find/person/px24l0688496r9r29n8ln"
      },
      {
        "name": "Ruth Miller",
        "age": 92,
        "id": "pn0u9u2920lr6499r42u",
        "url": "https://www.truepeoplesearch.com/find/person/pn0u9u2920lr6499r42u"
      },
      {
        "name": "Savannah Miller",
        "age": 31,
        "id": "pnnlnl8nrn9206u0ru9r",
        "url": "https://www.truepeoplesearch.com/find/person/pnnlnl8nrn9206u0ru9r"
      },
      {
        "name": "Shannan Miller",
        "age": 57,
        "id": "pu6l992l9r06802288u2",
        "url": "https://www.truepeoplesearch.com/find/person/pu6l992l9r06802288u2"
      }
    ],
    "associates": [
      {
        "name": "James Cocks",
        "age": 63,
        "id": "pu8nuu6l8844rnlunn9u",
        "url": "https://www.truepeoplesearch.com/find/person/pu8nuu6l8844rnlunn9u"
      },
      {
        "name": "John Chalmers",
        "age": 40,
        "id": "pxr4r9l040244nr66nrr",
        "url": "https://www.truepeoplesearch.com/find/person/pxr4r9l040244nr66nrr"
      },
      {
        "name": "Keir Chipperfield",
        "age": 37,
        "id": "pxn0lr4906r0n08run9ll",
        "url": "https://www.truepeoplesearch.com/find/person/pxn0lr4906r0n08run9ll"
      },
      {
        "name": "Ann Giovinazzo",
        "age": 63,
        "id": "p2982r840n89024l2n20",
        "url": "https://www.truepeoplesearch.com/find/person/p2982r840n89024l2n20"
      },
      {
        "name": "Arlene Pierro",
        "age": 90,
        "id": "p24ru9280rl402nn49nl",
        "url": "https://www.truepeoplesearch.com/find/person/p24ru9280rl402nn49nl"
      },
      {
        "name": "Dorothy Brewer",
        "age": 64,
        "id": "px9026n898920uu000u8u",
        "url": "https://www.truepeoplesearch.com/find/person/px9026n898920uu000u8u"
      },
      {
        "name": "Jenna Pierro",
        "age": 29,
        "id": "px4848ll98u6n9820n6n8",
        "url": "https://www.truepeoplesearch.com/find/person/px4848ll98u6n9820n6n8"
      },
      {
        "name": "Jessica Adams",
        "age": 40,
        "id": "pxu942lr842u8ul940r6r",
        "url": "https://www.truepeoplesearch.com/find/person/pxu942lr842u8ul940r6r"
      },
      {
        "name": "John Bledsoe",
        "age": 78,
        "id": "p8n204248680nrlu00n4",
        "url": "https://www.truepeoplesearch.com/find/person/p8n204248680nrlu00n4"
      },
      {
        "name": "Julia Cirigliano",
        "age": 25,
        "id": "px6r40884046l2822l99l",
        "url": "https://www.truepeoplesearch.com/find/person/px6r40884046l2822l99l"
      },
      {
        "name": "Kara Pierro",
        "age": 27,
        "id": "px6u200rn9rl6908nn4l2",
        "url": "https://www.truepeoplesearch.com/find/person/px6u200rn9rl6908nn4l2"
      },
      {
        "name": "Kimberly Krafft",
        "age": 60,
        "id": "px668u8r289rnr202ull6",
        "url": "https://www.truepeoplesearch.com/find/person/px668u8r289rnr202ull6"
      },
      {
        "name": "Michael Pierro",
        "age": 64,
        "id": "p9nl0424rl0rl208n0l",
        "url": "https://www.truepeoplesearch.com/find/person/p9nl0424rl0rl208n0l"
      },
      {
        "name": "Nicholas Cirigliano Jr",
        "age": 85,
        "id": "pl098nu2nn0l49rlrruu",
        "url": "https://www.truepeoplesearch.com/find/person/pl098nu2nn0l49rlrruu"
      },
      {
        "name": "Ronald Bledsoe",
        "age": 69,
        "id": "pu69uur20l0nr24lr809",
        "url": "https://www.truepeoplesearch.com/find/person/pu69uur20l0nr24lr809"
      },
      {
        "name": "Susan Johnson",
        "age": 79,
        "id": "px22rrnr48rln20882rnn",
        "url": "https://www.truepeoplesearch.com/find/person/px22rrnr48rln20882rnn"
      },
      {
        "name": "Vivian Pope",
        "age": 71,
        "id": "pu0906208u902689ru4",
        "url": "https://www.truepeoplesearch.com/find/person/pu0906208u902689ru4"
      }
    ]
  }
]

Requests and billing

  • Requests: 1–3 Web Access requests per entry in items.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.