Click Listing API

The Click Listing API and iFrame options allow you to dynamically retrieve or embed offer listings tied to specific transactions. Use these tools to extend Pingtree-powered listings into your external environments like custom funnels, landing pages, or partner sites.

​

Click Listing API Endpoint

Use the Click Listing API to retrieve listings programmatically for a given transaction.

• API URL Template:

https://api.pingtree.com/click/list/cp379/[[transaction_id]]

Replace [[transaction_id]] with the actual transaction ID generated during the form submission.

• Generate Token: Click Generate New Token to create an authentication token. Use Copy Token to copy it for use in the request.

• Header Format:

{
  "Authorization": "Bearer <your_token>"
}

​

Use Case:

Send a transaction_id to retrieve personalized offer blocks for that lead. The API response returns listing details such as:

• Offer title
• CTA highlights
• Redirection URLs
• Mapped lead fields (if configured)

​

Response Codes:

Reference status codes are available in the interface to help interpret the results.

​

Click Listing iFrame

Use the iFrame embed option to display listings visually within your own site or landing page.

​

Whitelist Domain (Optional):

Toggle Enable Whitelist to restrict iframe visibility to a specific domain.

• Enter only the domain name (e.g., yourdomain.com) without http:// or https://.
• Click Submit to save.

​

iFrame Embed Code:

A ready-to-use <iframe> code is auto-generated with the embedded transaction_id in the URL. This renders a fully styled click listing UI tailored to the associated lead data.

​

Note:

• The iframe must be placed on a page that includes a valid transaction_id generated by Pingtree. If this ID is missing or invalid, no listings will appear.