People Search API Documentation

1. Introduction

The API allows searching for people using various criteria such as name, state, city, postal code, phone number, email, and username. Additionally, it enables retrieving a complete profile of a person using a unique identifier.

Base URL

https://api2.tecnologiasdevenezuela.com/v3

2. Authentication & Security

To ensure the security of API requests, authentication is required using an API key. Each request must include the API key in the request body.

Authentication Method

• The API uses an API Key authentication system.
• Each user is assigned a unique API key.
• The key must be included in the request payload for every API call.

Example Request with API Key

curl -X POST https://api2.tecnologiasdevenezuela.com/v3 \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "YOUR_API_KEY_HERE", "fn": "John", "ln": "Doe", "page": 1}'

Handling Unauthorized Requests

If a request is made without a valid API key, the API will return a 401 Unauthorized response.

Example Response:

{
  "status": "error",
  "message": "Unauthorized. Invalid API key."
}

3. Endpoints

People Search

Method: POST

URL:

https://api2.tecnologiasdevenezuela.com/v3

Description:
This endpoint allows searching for people using various filters. A JSON object with search parameters must be sent in the request body, including the API key.

Input Parameters

Parameter	Type	Description
apiKey	String	API key required for authentication
fn	String	First name
mn	String	Middle name (optional)
ln	String	Last name
ln2	String	Second last name (optional)
page	Integer	Page number
limit	Integer	Limit of results per page (optional)
state	String	State
region	String	Region
city	String	City
zip	Integer	Postal code (optional)
phone	Integer	Phone number
email	String	Email address
username	String	Username

Response Parameters

Parameter	Type	Description
time	Float	Timestamp of the request
status	String	Status of the response (ok or error)
mensaje	Array	Messages related to the response
server	String	Server details
dataSet	String	Data source identifier
queryCacheada	Boolean	Indicates if the query was retrieved from cache
totalResultados	String	Total number of results found
exactMatch	Boolean	Whether the search results are an exact match
columnasEnNucleo	Boolean	Whether the results include core columns
registros	Integer	Number of records returned
persons	Array	List of matched persons
id	String	Unique identifier for the person
name	String	Full name of the person
dob	String	Date of birth in YYYYMMDD format. If month or day is unknown, it is 00.
locations	Array	List of locations associated with the person
akas	Array	List of alternative names
is_married	Boolean	Whether the person is married
phonesObj	Array	List of phone numbers and their details
emailsObj	Array	List of email addresses
imgs	Integer	Number of associated images

Date of Birth (dob) Format

• The dob parameter follows the format YYYYMMDD.
• If the month (MM) or day (DD) is unknown, it should be replaced with 00.
• Examples:
  • "dob": "19850615" → June 15, 1985.
  • "dob": "19850600" → June, 1985, day unknown.
  • "dob": "19850000" → Year 1985, month and day unknown.

Example Requests

Search for People

curl -X POST https://api2.tecnologiasdevenezuela.com/v3 \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "YOUR_API_KEY_HERE", "fn": "John", "ln": "Doe", "page": 1}'

Search for a Specific Profile

curl -X POST https://api2.tecnologiasdevenezuela.com/v3 \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "YOUR_API_KEY_HERE", "id": "-1234567890123456789"}'

Example Responses

Response for People Search

{
  "time": 1738519788.888751,
  "status": "ok",
  "mensaje": ["Se estimo el total y el nucleo desde la cache"],
  "server": "Apache/2.4.37 (centos) OpenSSL/1.1.1k (api2.tecnologiasdevenezuela.com)",
  "dataSet": "azerch",
  "queryCacheada": true,
  "totalResultados": "5000",
  "exactMatch": true,
  "columnasEnNucleo": false,
  "registros": 10,
  "persons": [
    {
      "id": "-9876543210987654321",
      "name": "Mr. John Doe",
      "locations": ["New York, NY"],
      "akas": ["John Doe", "Jonathan Doe", "Mr. J Doe"],
      "is_married": false,
      "age": 45
    }
  ],
  "imgs": 5
}

Response for a Specific Profile

{
  "time": 1738520658.909246,
  "status": "ok",
  "mensaje": [],
  "server": "Apache/2.4.37 (centos) OpenSSL/1.1.1k (api2.tecnologiasdevenezuela.com)",
  "dataSet": "dataset1",
  "queryCacheada": false,
  "totalResultados": 1,
  "exactMatch": true,
  "columnasEnNucleo": false,
  "registros": 1,
  "persons": [
    {
      "id": "-1234567890123456789",
      "name": "James A Smith Jr",
      "dob": "19650000",
      "locations": ["Los Angeles, CA"],
      "akas": ["James Smith", "Jim Smith", "J A Smith Jr"],
      "is_married": false
    }
  ],
  "imgs": 1
}

Requesting an API Key

To request an API key, please contact support@telephonedirectories.us.