The TDG API enhances data by offering a suite of functionalities designed to verify, look up, and append information. Through its various endpoints, the API provides tailored solutions that cater to specific user needs. Each endpoint is dedicated to a distinct function, allowing users to efficiently manage and enrich their data according to their requirements. Whether you need to validate data accuracy, perform detailed lookups, or add supplementary information, the TDG API's comprehensive features ensure that you have the tools necessary to optimize your data management processes.
Get Your API Key
To obtain an API key, please contact us. Our team will respond and provide your API key within 24 hours.
To access data, you must authenticate your requests using an API Key. By authenticating your requests with an API Key, you ensure secure and authorized access to our data services, allowing you to integrate our comprehensive and reliable data seamlessly into your applications and workflows.
API Keys
Obtaining an API Key
To obtain an API key, please contact us. Our team will respond and provide your API key within 24 hours.
API Keys ensure secure access to our APIs by verifying the identity of the requester. They prevent unauthorized access and help protect sensitive data and resources.
Including the API Key in Requests
When interacting with our data services through APIs, SDKs, or command-line interfaces (CLI), it's essential to include your API Key in the request. This API Key acts as a unique identifier that authenticates and authorizes your request to access our data. Detailed documentation for each method specifies how to configure and use your API Key.
Managing Your API Key
Proper management of your API Key is crucial. Ensure it is kept confidential and not shared publicly or hard-coded in client-side applications. Rotate your keys periodically and revoke them immediately if compromised.
Best Practices
Use HTTPS to encrypt API Key transmissions over the network, preventing interception by unauthorized parties.
Implement rate limiting and access controls based on API Key usage to manage and monitor access effectively.
APIs Overview
The TDG API enriches the data and provides functionality to verify, lookup or append the data through APIs which have different endpoints to serve different functionality based on the user's needs.
They follows RESTful conventions when possible, with most operations performed via POST requests on database resources. Request and response bodies are encoded as JSON.
Get Your API Key
To obtain an API key, please contact us. Our team will respond and provide your API key within 24 hours.
HTTPS is required for all API requests. The TDG API follows RESTful conventions when possible, with most operations performed via POST requests on database resources. Request and response bodies are encoded as JSON.
Supported Endpoints
Our API provides various endpoints categorized into Append, Lookup, and Verify to cater to your specific data needs. These categories help you enhance, retrieve, and validate your data efficiently.
Append Endpoints
Append endpoints are used to enrich your existing records by adding missing information. This helps to create a more complete and accurate database, improving your ability to communicate with and understand your customers.
Lookup Endpoints
Lookup endpoints are designed to retrieve detailed information associated with specific data points. This allows you to gain deeper insights and verify the accuracy of your existing data.
Verify Endpoints
Verify endpoints ensure the data you have is accurate and up-to-date. These endpoints are essential for maintaining data quality and ensuring compliance with regulations.
End Point
Description
Auto Append
Automatically append missing data to your records.
Demographic Append
Append demographic details like age, gender, and income.
Email Append
Append email addresses to your contact records.
Phone Append
Append phone numbers to your existing records.
Email Lookup
Retrieve information associated with email addresses.
Email Verify
Verify the accuracy and deliverability of email addresses.
TCPA Verify
Verify phone numbers for compliance with TCPA regulations.
ID Verify
Verify the identity of individuals to prevent fraud.
API Response Codes
Understanding API response codes is essential for handling the outcomes of your API requests effectively. Here is a list of possible response codes and their descriptions:
HTTPS STATUS CODE
Description
200
Successful
204
No Records found
400
Missing required parameter(s)
440
Too many results. Please refine your search criteria
429
You have reached the maximum number of transactions allowed
401
The user is invalid (verify your credentials)
500
System error. Retry search, if failure continues, contact support
SDKs
The TDG SDK is an open-source project designed to simplify the process of integrating our data services into your applications. By using the SDK, developers can easily access and utilize our API functionalities, ensuring a smooth and efficient development experience.
Postman is a powerful tool that simplifies API development and testing. It allows you to easily create, test, and manage your API requests without writing any code. Using Postman with the TDG API provides a user-friendly way to explore and integrate our data services.
Append email addresses to your existing contact records to improve communication channels and marketing outreach.
HEADERS
x-api-key
string
required
Unique key obtained after contacting us. This is required.
BODY PARAMS
FName
string
conditionally required*
First name, 15 characters max.
*Required if LName, Address1, Zip is included
LName
string
conditionally required*
Last name, 20 characters max
*Required if FName, Address1, Zip is included
Address1
string
conditionally required*
Address line 1, 64 characters max.
*Required if FName, LName and Zip is included
Zip
string
conditionally required*
5 digit numeric USPS zip code.
*Required if FName, LName and Address is included. Either City/State or Zip is required.
Suppression
string
optional*
Suppress records containing restrictions, True or False. Default: Suppression=True.
includemonths
string
optional*
Integer value in months. For example, IncludeMonths=24 would include records that have been validated within the last 2 years. By default, all matches are included regardless of validation date.
*FullName, Address1 and Zip parameters are required altogether.
max_score
string
optional*
Filters by Match Score, 3 characters max. maxscore=299 will include all individual and household level matches
*FullName, Address1 and Zip parameters are required altogether.
Elevate your customer interactions and value with cutting-edge technology and a commitment to managing your data responsibly. Stay ahead of the competition by choosing to partner with The Data Group. Schedule a demo today to learn how we can help move your business forward.
Connect your data across various channels and systems, eliminating duplicate entries and ensuring a unified data landscape. This integration helps streamline your operations and ensures consistency across platforms.
Tailored Demos and Pricing:
Experience personalized demos designed to meet your unique business needs. Our pricing insights are structured to suit your budget, providing flexibility and scalability as your business grows.