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.