LinkedIn posts

V2 Prospects Linkedin Posts Enrich

curl --request POST \
  --url https://api.explorium.ai/v2/prospects/linkedin_posts/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "prospect_ids": "<string>",
  "request_context": null,
  "parameters": {}
}
'

import requests

url = "https://api.explorium.ai/v2/prospects/linkedin_posts/enrich"

payload = {
    "prospect_ids": "<string>",
    "request_context": None,
    "parameters": {}
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({prospect_ids: '<string>', request_context: null, parameters: {}})
};

fetch('https://api.explorium.ai/v2/prospects/linkedin_posts/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.explorium.ai/v2/prospects/linkedin_posts/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prospect_ids' => '<string>',
    'request_context' => null,
    'parameters' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.explorium.ai/v2/prospects/linkedin_posts/enrich"

	payload := strings.NewReader("{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/prospects/linkedin_posts/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v2/prospects/linkedin_posts/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "data": [
    {
      "prospect_id": "<string>",
      "data": {
        "display_name": "<string>",
        "post_text": "<string>",
        "days_since_posted": 123,
        "post_url": "<string>",
        "number_of_comments": 123,
        "number_of_likes": 123,
        "created_at": "2023-11-07T05:31:56Z"
      }
    }
  ],
  "total_results": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

prospects

linkedin_posts

enrich

V2 Prospects Linkedin Posts Enrich

curl --request POST \
  --url https://api.explorium.ai/v2/prospects/linkedin_posts/enrich \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "prospect_ids": "<string>",
  "request_context": null,
  "parameters": {}
}
'

import requests

url = "https://api.explorium.ai/v2/prospects/linkedin_posts/enrich"

payload = {
    "prospect_ids": "<string>",
    "request_context": None,
    "parameters": {}
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({prospect_ids: '<string>', request_context: null, parameters: {}})
};

fetch('https://api.explorium.ai/v2/prospects/linkedin_posts/enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.explorium.ai/v2/prospects/linkedin_posts/enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'prospect_ids' => '<string>',
    'request_context' => null,
    'parameters' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.explorium.ai/v2/prospects/linkedin_posts/enrich"

	payload := strings.NewReader("{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.explorium.ai/v2/prospects/linkedin_posts/enrich")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.explorium.ai/v2/prospects/linkedin_posts/enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"prospect_ids\": \"<string>\",\n  \"request_context\": null,\n  \"parameters\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "response_context": {
    "correlation_id": "<string>",
    "time_took_in_seconds": 123
  },
  "data": [
    {
      "prospect_id": "<string>",
      "data": {
        "display_name": "<string>",
        "post_text": "<string>",
        "days_since_posted": 123,
        "post_url": "<string>",
        "number_of_comments": 123,
        "number_of_likes": 123,
        "created_at": "2023-11-07T05:31:56Z"
      }
    }
  ],
  "total_results": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Introduction

The Individual’s Social Media Presence Enrichments API provides insights into a prospect’s social media activity. This endpoint retrieves public posts from professional networks, allowing businesses to analyze engagement trends, content topics, and prospect interests for better outreach and marketing strategies.

Credit usage — charged per requested IDUnlike other enrichment endpoints, which charge credits only for entity IDs that return results, this endpoint charges credits for every prospect_id included in the request — whether or not results are returned. A request that returns no posts still consumes credits.

Key Benefits:

Gain real-time visibility into a prospect’s social media activity.
Understand professional interests, opinions, and engagement.
Improve personalized outreach by leveraging recent posts and topics of discussion.
Track changes in professional communication patterns over time.

v2: this endpoint accepts either a single ID (a string) or a list of up to 50 IDs — the separate /bulk_enrich route is gone. See v2 conventions.

How It Works

Input: Provide a prospect_id (retrieved from the Match Prospects endpoint) to fetch their social media data.
Processing: The system gathers publicly available social media posts and organizes them into a structured format.
Output: A response containing recent posts, links to content, and engagement details.

Request Schema

Field	Type	Description
`prospect_id`	String	A unique identifier for the prospect (Required)

Credit Usage

This endpoint uses a different charging model than other enrichment endpoints:

Endpoint type	Charging model
Other enrichment endpoints	Credits charged per entity ID that returns results — no results, no charge.
This endpoint (LinkedIn posts)	Credits charged per requested `prospect_id`, regardless of whether results are returned.

To avoid spending credits on IDs that are unlikely to return data, make sure you use valid prospect IDs retrieved from the Match Prospects endpoint.

Best Practices

Use verified prospect IDs for accurate enrichment.
Analyze engagement patterns to tailor marketing efforts.
Store and categorize insights in your CRM for future reference.
Leverage content analysis for personalized outreach.
Monitor recent social media activity to track industry trends and thought leadership.

Signal	API Name	Description	Data Type Final
created_at	Time of posting	Timestamp of when the individual’s post was published.	datetime
number_of_likes	Number of post likes	Number of likes the individual’s post received by time of collection.	integer
post_url	LinkedIn® post URL	URL to the LinkedIn® post published by individual.	url
number_of_comments	Number of post comments	Number of comments on the individual’s post by time of collection.	integer
days_since_posted	Days since post	Number of days since the post was published by the individual.	integer
post_text	Post text content	Text content of the LinkedIn® post published by individual.	string

Key Consideration:

Credits are charged per requested prospect_id, even when no results are returned — unlike other enrichment endpoints, which charge only for IDs that return data.
Posts retrieved are from publicly available social media content.
Engagement data (likes, comments) may not always be available.
Ensure valid prospect IDs (from Match Prospects) to retrieve accurate data.
Use insights for trend analysis, competitor research, and engagement tracking.

Body Params - Try Me Example

prospect_id: ee936e451b50c70e068e1b54e106cb89173198c4

Authorizations

api_key

string

header

required

Body

application/json

prospect_ids

required

Pattern: ^[a-f0-9]{40}$

request_context

Request Context · object | null

Example:

null

parameters

LinkedInPostsEnrichmentParams · object

Response

Successful Response

This is base response model for all responses in partner service.

response_context

ResponseContext · object

required

Show child attributes

data

V2ProspectEnrichRow[LinkedinProspectsPostsOutputSchema] · object[]

required

Show child attributes

total_results

integer

required

⌘I

Getting started

Businesses

Business enrichments

Prospects

Prospect enrichments

Research (GenAI)

Async jobs

Autocomplete

Credits

Events & Webhooks

Introduction

Body Params - Try Me Example

Authorizations

Body

Response

​Introduction

​Body Params - Try Me Example

Authorizations

Body

Response

Introduction

Body Params - Try Me Example