> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up LeadsPedia Integration

> Learn how to connect LeadsPedia to LanderLab to send leads directly to your LeadsPedia campaigns in real time using Direct Post or Ping-Post.

> Connect LeadsPedia to your landing pages in LanderLab to send lead data directly to your LeadsPedia campaigns in real time. Choose between Direct Post and Ping-Post depending on your lead distribution setup.

## What is LeadsPedia?

LeadsPedia is a lead distribution and management platform used by lead generation companies, advertisers, and affiliate networks to collect, validate, route, and sell leads in real time. It supports both direct posting and ping-post workflows, making it a popular choice for performance marketers working across multiple verticals.

When you connect LeadsPedia to your landing page in LanderLab, every lead collected on your page is automatically sent to your LeadsPedia campaign using the posting method you choose. LanderLab handles the API connection for you, so you do not need to write any custom code or build server-side integrations.

<Note>
  LeadsPedia integrations are **not** saved globally. Each integration is configured per landing page, so you will need to set up a new LeadsPedia connection for each landing page where you want to send leads.
</Note>

***

## Direct Post vs. Ping-Post

LanderLab supports two posting types for LeadsPedia. You choose the type during setup based on how your LeadsPedia campaign is configured.

**Direct Post** sends the full lead data to LeadsPedia in a single request. This is the simplest method and is used when leads go directly to a specific campaign without a bidding step.

**Ping-Post** is a two-step process. First, a "ping" is sent with partial lead data so LeadsPedia can check if any buyers want the lead and return a bid. If a bid is accepted, a second "post" is sent with the full lead details. This method is used in lead distribution setups where multiple buyers compete for each lead.

***

## How to Add LeadsPedia

The LeadsPedia setup uses a 3-step wizard: configure the connection, map your fields, and review the final payload before connecting.

### Step 1: Configure the Connection

<Steps>
  <Step title="Go to your landing page">
    Navigate to **Landing Pages** and click the **name of the landing page** where you want to add the LeadsPedia integration.
  </Step>

  <Step title="Open the Integrations tab">
    Click **Add Integration** to open the integrations panel.
  </Step>

  <Step title="Select LeadsPedia integration">
    From the list of available integrations, find **LeadsPedia integration** (labeled as "Send leads to LeadsPedia in real time") and click on it. The configuration wizard will open.
  </Step>

  <Step title="Fill in the connection details">
    Start by entering a **Name** for this integration (e.g. "LeadsPedia - Auto Loans"). Then select the **Type** based on your LeadsPedia campaign setup:

    **If you select Direct Post:**

    | Field               | Description                                                                                     |
    | :------------------ | :---------------------------------------------------------------------------------------------- |
    | **Post URL**        | The LeadsPedia post endpoint URL (e.g. `https://api.leadspedia.com/.../post`).                  |
    | **LP Campaign ID**  | The numeric Campaign ID from your LeadsPedia campaign (e.g. `12345`).                           |
    | **LP Campaign Key** | The Campaign Key associated with your LeadsPedia campaign. This is generated inside LeadsPedia. |

    **If you select Ping-Post:**

    | Field               | Description                                                                                     |
    | :------------------ | :---------------------------------------------------------------------------------------------- |
    | **Ping URL**        | The LeadsPedia ping endpoint URL (e.g. `https://api.leadspedia.com/.../ping`).                  |
    | **Post URL**        | The LeadsPedia post endpoint URL (e.g. `https://api.leadspedia.com/.../post`).                  |
    | **LP Campaign ID**  | The numeric Campaign ID from your LeadsPedia campaign (e.g. `12345`).                           |
    | **LP Campaign Key** | The Campaign Key associated with your LeadsPedia campaign. This is generated inside LeadsPedia. |

    <Tip>
      To find your **LP Campaign ID** and **LP Campaign Key**, log in to LeadsPedia, open your campaign, and click the **Post Keys** button in the top menu. Both values will be displayed there. You can also find them under **Generate Posting Instructions** in the left sidebar.
    </Tip>
  </Step>

  <Step title="Click Continue">
    Click **Continue** to move to the field mapping step.
  </Step>
</Steps>

***

### Step 2: Map Your Fields

In this step, you choose which data fields to include in the request and how they should be named when sent to LeadsPedia.

<Steps>
  <Step title="Select and configure fields">
    LanderLab automatically includes a set of default LanderLab fields. Each field has a checkbox to include or exclude it, and a **Sent As** column where you can rename the key to match what LeadsPedia expects.

    The default LanderLab fields are:

    | Form Field                 | Sent As (default key)    | Description                                          |
    | :------------------------- | :----------------------- | :--------------------------------------------------- |
    | **LL Lander URL**          | `ll_lander_url`          | The full URL of the landing page the visitor was on. |
    | **LL Visitor IP**          | `ll_visitor_ip`          | The IP address of the visitor.                       |
    | **LL Visitor User Agent**  | `ll_visitor_user_agent`  | The browser and device information of the visitor.   |
    | **LL Submission Time UTC** | `ll_submission_time_utc` | The date and time the lead was submitted (in UTC).   |
    | **LL Variant ID**          | `ll_variant_id`          | The A/B test variant ID the visitor was shown.       |

    Use the checkboxes to enable or disable any field. You can also edit the **Sent As** value to match the field names your LeadsPedia campaign expects.

    <Tip>
      If your landing page includes a **quiz funnel** or **form**, all the form fields you have added (such as name, email, phone, address, and any custom inputs) will automatically appear in this field list alongside the default LanderLab fields. You can enable, disable, or rename them just like the default fields.
    </Tip>
  </Step>

  <Step title="Add custom fields (optional)">
    Under the **Additional fields** section, click **+ Add field** to include extra key-value pairs in the request. This is useful for sending static values like a sub ID, lead source tag, or any custom parameter your LeadsPedia campaign requires.
  </Step>

  <Step title="Click Continue">
    Click **Continue** to move to the review step.
  </Step>
</Steps>

***

### Step 3: Review and Connect

<Steps>
  <Step title="Review your LeadsPedia integration">
    The final step shows a complete summary of what will be sent to LeadsPedia for every lead. You will see:

    * The **posting type** (Direct Post or Ping-Post) and integration name
    * The **configuration** section showing your Campaign ID, Campaign Key, and Post URL (and Ping URL if using Ping-Post)
    * The **field mapping** section listing all fields and their corresponding template variables (e.g. `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Review everything carefully to make sure the configuration and field names match what your LeadsPedia campaign expects.
  </Step>

  <Step title="Click Connect LeadsPedia">
    If everything looks correct, click the **Connect LeadsPedia** button to save and activate the integration. If you need to change anything, click **Back** to return to the previous steps.
  </Step>
</Steps>

***

## Where to Find Your LeadsPedia Campaign ID and Campaign Key

If you are not sure where to find your Campaign ID and Campaign Key, follow these steps:

1. Log in to your LeadsPedia account.
2. Open the campaign you want to connect.
3. Click the **Post Keys** button in the top menu bar of the campaign window.
4. Your **Campaign ID** and **Campaign Key** will be displayed.

You can also find these values by going to **Generate Posting Instructions** in the left sidebar, selecting your vertical, offer, and campaign, and choosing "Server Post with Campaign ID and Campaign Key" as the type.

<Warning>
  If you regenerate the Campaign Key inside LeadsPedia, the previous key will stop working. Make sure to update the key in LanderLab if you regenerate it.
</Warning>

***

## Common Use Cases

* **Direct lead delivery** - Use Direct Post to send leads straight to a specific buyer or internal campaign without a bidding step.
* **Lead marketplace distribution** - Use Ping-Post to let multiple buyers bid on your leads in real time and sell to the highest bidder.
* **Multi-vertical campaigns** - Set up different LeadsPedia integrations on different landing pages to route leads to the correct vertical and campaign.
* **Affiliate lead posting** - If you are an affiliate, use the Campaign ID and Campaign Key provided by your lead buyer to post leads directly into their LeadsPedia account.
