Skip to main content

Email & Phone Enrichment

The eCore Service API allows you to enrich your contact data with phone numbers or email addresses using minimal identifying information, such as LinkedIn URLs or name and company details. Enhance CRM records, streamline sales prospecting, or build enriched contact lists with these powerful endpoints.

Overview​

The Enrichment API enhances existing phone numbers or email addresses with additional data, such as LinkedIn profile URLs, using a secure, token-based authentication system.

Base URL​

The base URL for the API is https://getmobile.ecoreservice.com/.

Authentication​

Access requires a valid authentication token passed as a query parameter named token in every request URL.

Example: ?token=your_auth_token_here

Enrichment Endpoints​

The API provides two main endpoints for enrichment: Phone Enrichment and Email Enrichment.

Phone Enrichment​

Endpoint: /phone/enrichment/
Method: POST
Description: Retrieve or associate phone numbers for business contacts using identifiers like LinkedIn URL, email, or name and company details.

Request Body​

  • Content-Type: application/json
  • Fields:
    • linkedin_url (String, required): The LinkedIn profile URL to retrieve or associate phone data.

Example cURL Request (Phone Enrichment)​

curl --location --request POST 'https://getmobile.ecoreservice.com/phone/enrichment/?token=a98d1d8a-afed-4318-8f7b-027c85ddbb8c' \
--header 'Content-Type: application/json' \
--data-raw '{
    "linkedin_url": "https://www.linkedin.com/in/ritzman"
}'

Email Enrichment​

Endpoint: /email/enrichment/
Method: POST
Description: Enrich email addresses with additional data, such as LinkedIn profile URLs, using similar identifiers.

Request Body​

  • Content-Type: application/json
  • Fields:
    • linkedin_url (String, required): The LinkedIn profile URL to retrieve or associate email data.

Example cURL Request (Email Enrichment)​

curl --location --request POST 'https://getmobile.ecoreservice.com/email/enrichment/?token=a98d1d8a-afed-4318-8f7b-027c85ddbb8c' \
--header 'Content-Type: application/json' \
--data-raw '{
    "linkedin_url": "https://www.linkedin.com/in/ritzman"
}'

Expected Response​

A successful request returns a JSON object with enriched data. The response structure varies based on the endpoint.

Example (Successful Response)​

{
  "status": "success",
  "results": {
    "phone": "1 330 283 2977"
  }
}

Error Handling​

The API uses standard HTTP status codes for errors:

  • 400 Bad Request: Missing or invalid parameters in the request body.
  • 401 Unauthorized: Invalid or missing authentication token.
  • 404 Not Found: The requested resource or endpoint does not exist.
  • 500 Internal Server Error: Unexpected server error.

Example (Error Response)​

{
  "status": "error",
  "message": "Invalid authentication token",
  "code": 401
}

Try It Out​

Explore the Enrichment API in the API Playground (password: EluuEz0J). Test endpoints, authenticate with your API key, and view real-time responses.