Trestle’s Reverse Phone API, Caller Identification API, and Smart CNAM API all support a request parameter called Name Hint. We have documented in detail on when to use the feature here.
To summarize:
A phone can be associated with multiple names. This can be due to a business LLC, as well as the individual person associated with the phone. Or, Trestle has both the account holder name and the individuals who actually carry the phone associated with the number. In both cases, businesses might already have some details about this phone number through a lead contact form or from their CRM and are looking for up-to-date information about this phone number, like addresses, additional phone numbers, or demographic details. Providing a name hint as part of the request parameter gives a hint to Trestle to prioritize all the details about this specific person associated with the phone number.
Here is an example scenario:
Jon Snow
- Phone: 555-555-1212
- Current Address: Seattle, WA
- Historical Address: New York, NY
- Additional Number: 999-999-2424
- Household People: Ned Stark, Robb Stark, Arya Stark
The North LLC
- Phone: 555-555-1212
- Registered Address: Seattle, WA
If the business wants to specifically know more about Jon Snow, they will send the query as follows:
api.trestleiq.com/3.1/phone?api_key=[insertkey]&phone=5555551212&phone.name_hint=Jon+Snow
With this hint, Trestle will prioritize the response set for Jon Snow and send the details for Jon Snow. There are additional points to make, though.
We want to emphasize that this is not about offloading the accuracy work to our customers. Trestle is focused 100% on that and will continue to iterate there. This is, however, about taking into consideration various verticals and use cases that we serve and optimizing our product to their specific needs.
We also want to note that we will not use Name Hint to improve our coverage and associate the name hint name to the phone in our database. The query parameter is just used to improve our ranking algorithms. As mentioned above, if we do not have a name associated with the phone or the name hint provided doesn’t match any of the names we have, we will continue with our internal algorithms for ranking the data available.
We see this feature used most by businesses looking for lead enrichment where they already have the lead data from form fills or from an acquired lead list. If you have any questions or need any assistance to get this rolled out for your business, you can reach out to support@trestleiq.com.