Ping & Post API

Posting Instructions Fields Required Ping API Shared Leads Post Direct Post by ZIP List
Health Ins. Home Ins. Legal Auto Ins. Home Services Life ins. Finance / Debt.
Calls
Call Home services Call Auto Ins. Call Health Ins. Call Legal. Call Finance/Debt.

Ping & Post Instructions
for Home Improvement

Adopt a contractor API
Please use the following instructions to use our Ping/Post or Direct Post system for Home Improvement Vertical.
In order to get identified, you will need to send the following parameters:
Ping
Required 		Post
Required 		field Contents Example of value
YES YES partnerid Will be provided XYZ
YES YES key Will be provided 771f5924706521c73464341fc48afb05
YES YES numcategory
Carpentry
24 - Cabinets/Drawers Installation 
additional fields.
 
25 - Cabinet Repair   
27 - Closets/Built-in Furniture   
28 - Custom Carpentry/Woodworking   
29 - Decks/Porches/Ramps - Build   
show all
Cleaning
Concrete Masonry
Electrical
Pest Control
Fencing
Flooring
Garage Doors
Handyman
HVAC
Landscaping
Painting
Plumbing
Remodeling
Roofing
Tiling
Siding
Windows
Solar Panels
Appliances
Others
Insulation
Locksmith
Home Security
Moving
Sunrooms
Gutters
70
YES YES subid Your sub Source 123
OPTION OPTION resptype 'XML' to receive an XML response.
'JSON' to receive an JSON response.
if empty, the response format will be by default. 		XML
YES price The payout for the lead in $.
 0.15
NO OPTION price_tag 1 to receive the Price inside the Post response.
if empty, the response format will be by default. (See response example)		 1
NO YES token Value you received in case of positive Ping.
Must be sent on the Post.		 e69412030cc93b47cf5be6f7e3ee998c
Fields Required for Home Improvement
Ping
Required 		Post
Required 		fieldname Value - Label Example of value
YES YES zipcode varchar(5) 33139
NO YES firstname varchar(50) John
NO YES lastname varchar(50) Doe
NO YES address varchar(100) 1210 Ocean Drive
NO YES telephone varchar(50) 8772681223
NO YES email varchar(50) john.doe@gmail.com
NO OPTION customid varchar(50) 12345
OPTION NO trusted_form_available 1 (Yes) 1 (for Yes) or 0 (for No)
OPTION NO universal_leadid_available 1 (Yes) 1 (for Yes) or 0 (for No)
OPTION OPTION lead_born_datetime Y-m-d h:i:s 2023-01-01 11:50:23
OPTION OPTION q22
OPTION OPTION state varchar(2) FL
OPTION OPTION tcpa_optin 1 (Yes) or 2 (No) 1
OPTION YES tcpa_text varchar(5000) The TCPA Text of the Lead
OPTION OPTION trusted_form_token varchar(250) 544fa56524d00e3a0cb321b988fc40d8c42c7160
OPTION OPTION universal_leadid varchar(50) AB6A63B1-09A6-5AA3-85BD-CBDA909D9BBE
OPTION OPTION user_agent varchar(255) Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36
OPTION OPTION city varchar(100) Miami
OPTION OPTION comments varchar(500) Free comment
OPTION OPTION ip varchar(50) 213.36.145.10
OPTION OPTION 1to1consent
complementary datas are requireds if 1to1consent is sent and ≠ 0
display complementary datas
 0 (No), 1 (Yes). 0 by default 0
OPTION OPTION shared
complementary datas are requireds if shared is sent and ≠ 0
display complementary datas
 1 (Yes) 0
PING API
Methods
You can call the PING API using three different methods:
  • cURL POST with URL-encoded data
  • cURL POST with JSON data
  • HTTP GET request

    Required Fields
    When making a PING request, the following fields are mandatory and must be included:
  • partnerid: Your unique partner ID.
  • key: Your API key for authentication.
  • numcategory: The category number for the service.
  • subid: Your unique sub ID.

    • In addition to the fields mentioned above, all fields marked as "Ping Required" with Yes in the "Fields Required" table above must also be included in the request.

    Response
    The API will respond in one of the following ways:
  • Accepted: We will return a price and a token that you can reuse in the POST API.
  • Rejected: The request will be rejected with a detailed reason provided in the response.
    TEST MODE
    Only For test Mode please :
  • use key = test_mode (The Live Mode Key will be provided upon completion of successful Test.)
  • use subid = match To simulate a positive response
    • For direct post according to a ziplist
  • add price = 0.5
    • #errorCode# Meaning
    1000 Server under maintenance
    1100 Request limit exceeded
    2000 Invalid Partner ID or Blocked source
    3000 Approval Phase
    4000 Daily Cap reached
    5000 No coverage or buyers
    6000 Minimum bid not met
    Other Ask Your Representative
    SHARED LEADS
    Request Parameters
    - Add the `shared` parameter: Include the parameter shared =1 to indicate that the lead being sent is a shared lead (non-exclusive).
    - Additional Parameters for Shared Leads:
  • nb_legs_available The number of legs (potential buyers) still available for this lead.
  • nb_legs_sold The number of legs (buyers) this lead has already been sold to.
  • hash_legs_sold A comma-separated list of SHA1-hashed phone numbers of the contractors to whom this lead has already been sold.
    • These parameters help the system manage shared leads efficiently by ensuring the lead is not resold to the same contractors.

    Responses
    Success for a Shared Lead:
    - If all parameters sent match the expected values, the system will respond with:
  • `ACCEPTED`: Confirmation that the shared lead is accepted.
  • `token`: A unique identifier for this lead submission.
  • `Price`: The price offered for the lead.
  • `nbLegs`: The number of legs (buyers) the system is interested in purchasing for this lead.
  • `hashes`: A comma-separated list of SHA1-hashed phone numbers of the potential contractors to whom the legs will be sold.


    • Failure
    - The response will mirror the failure response of an exclusive ping, indicating why the shared lead could not be accepted.
    POST API
    Required Fields
    When making a POST request, the following fields are mandatory and must be included:
  • partnerid: Your unique partner ID.
  • key: Your API key for authentication.
  • numcategory: The category number for the service.
  • subid: Your unique sub ID.
  • token: the token received on the Ping response.

    • In addition to the fields mentioned above, all fields marked as "Post Required" with Yes in the "Fields Required" table above must also be included in the request.

    Response
    The post API will respond in one of the following ways:
  • Accepted: see examples...
  • Rejected: if the leads is post rejected, .
    • DIRECT POST ACCORDING TO A ZIPLIST
    The Direct Post method allows you to submit leads in a single step, based on the Ziplist provided.
  • Your account must first be configured by an Affiliate Manager, we will define the price for each category and Ziplist based on the agreement.
  • Single-Step Process: Unlike the ping-post process, the Direct Post only requires a single submission (post). There is no need for a ping step.
  • Submit your leads to this endpoint https://api.letsmakealead.com/direct_post_partner.php
  • Pass the Post fields as in a standard API post. Exclude the token field and include the price field with the value based on the Ziplist provided by your representative.

    The response from the API is the same as in the standard Post process. You will receive a JSON or XML response indicating the status of the lead submission and any relevant details.

    • jerems14