Automated Lead Feedback API

Welcome to the Hunt Digital Media API Integration Guide. This document is designed to assist our advertisers in understanding and implementing our API for automated lead status updates. Our API facilitates real-time reporting and updates on lead dispositions, sub-dispositions, and call attempts, streamlining the process and enhancing the efficiency of our collaboration.

API Overview
The Hunt Digital Media API allows for the automated update of lead statuses directly into our system. By integrating with our API, advertisers can seamlessly report on:
  • Disposition outcomes of the leads.
  • Sub-dispositions providing additional details.
  • Number of attempts made to contact each lead.

API URL Structure

Below, we provide a detailed breakdown of the API URL and its parameters to ensure clear understanding and correct usage:

Base URL: https://ck.hdm3.in/et.php

Parameters:
  • eventid=494: A constant identifier for the event.
  • hid={Hunt-Unique-ID}: The unique identifier for each lead generated by our system.
  • dis={disposition}: The outcome of the call regarding the lead.
  • subdis={sub-disposition}: Further details on the call outcome.
  • callatt={no-of-call-attempt}: The total number of attempts made to contact the lead.
Parameter Descriptions
To ensure accurate data transmission, please adhere to the following guidelines for each parameter:
  • Hunt-Unique-ID (hid): This is a unique identifier assigned by our system to track each lead individually.
  • Disposition (dis): Indicates the final status of the call, such as 'Interested', 'Not Interested', or 'Callback Later'.
  • Sub-Disposition (subdis): Provides additional context on the lead status, such as 'Busy', 'No Answer', or 'Refused'.
  • Number of Call Attempts (callatt): Reflects how many times a contact was attempted for the lead.

Usage Examples
Here is how you can structure an API call:

https://ck.hdm3.in/et.php?eventid=494&hid=XYZ123&dis=Interested&subdis=Busy&callatt=3

Response Handling
Upon making an API call, you will receive one of the following responses:

Success Response

{ "status": "success", "message": "Lead feedback updated successfully." }

Error Response 

{ "status": "error", "message": "Invalid parameters provided." }

Support Contact
Should you have any questions or require assistance, please contact our support team at support@huntdigitalmedia.com. We are here to help ensure your integration process is smooth and successful.