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": [
    "ee936e451b50c70e068e1b54e106cb89173198c4"
  ]
}
'

import requests

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

payload = { "prospect_ids": ["ee936e451b50c70e068e1b54e106cb89173198c4"] }
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: ['ee936e451b50c70e068e1b54e106cb89173198c4']})
};

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' => [
        'ee936e451b50c70e068e1b54e106cb89173198c4'
    ]
  ]),
  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\": [\n    \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n  ]\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\": [\n    \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n  ]\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\": [\n    \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n  ]\n}"

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

{
  "response_context": {
    "correlation_id": "<string>",
    "request_status": "success",
    "time_taken_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": [
    "ee936e451b50c70e068e1b54e106cb89173198c4"
  ]
}
'

import requests

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

payload = { "prospect_ids": ["ee936e451b50c70e068e1b54e106cb89173198c4"] }
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: ['ee936e451b50c70e068e1b54e106cb89173198c4']})
};

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' => [
        'ee936e451b50c70e068e1b54e106cb89173198c4'
    ]
  ]),
  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\": [\n    \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n  ]\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\": [\n    \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n  ]\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\": [\n    \"ee936e451b50c70e068e1b54e106cb89173198c4\"\n  ]\n}"

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

{
  "response_context": {
    "correlation_id": "<string>",
    "request_status": "success",
    "time_taken_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.

Enrich by prospect details instead of IDs

prospect_ids is the primary way to call this endpoint. If you don’t have Explorium IDs yet, you can send prospects_to_match instead: up to 50 people, described with the same fields the Match prospects endpoint accepts (full_name, company_name, email, phone_number, linkedin, business_id). Each person is matched and enriched in the same call. Send either prospect_ids or prospects_to_match, never both (that returns a 422). Any parameters the endpoint takes work the same either way.

{
  "prospects_to_match": [
    { "full_name": "Jane Doe", "company_name": "Acme Corp" },
    { "full_name": "John Smith", "company_name": "Unknown Co" }
  ]
}

{
  "response_context": {
    "correlation_id": "9a1c0e7f4b2d4c6e8f0a1b2c3d4e5f60",
    "request_status": "success",
    "time_taken_in_seconds": 1.42
  },
  "data": [
    {
      "input": { "business_id": null, "full_name": "Jane Doe", "company_name": "Acme Corp", "email": null, "phone_number": null, "linkedin": null },
      "prospect_id": "4f1d9c2e7a3b5c8d0e6f1a2b3c4d5e6f7a8b9c0d",
      "data": { "...": "same fields as an ID-based request" },
      "warnings": []
    },
    {
      "input": { "business_id": null, "full_name": "John Smith", "company_name": "Unknown Co", "email": null, "phone_number": null, "linkedin": null },
      "prospect_id": null,
      "data": null,
      "warnings": []
    }
  ],
  "total_results": 1,
  "total_matches": 1
}

Each row echoes its input and returns the matched prospect_id. People who don’t match come back with prospect_id: null and data: null, and aren’t charged. total_matches counts the matched rows.

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_ids: ee936e451b50c70e068e1b54e106cb89173198c4

Authorizations

api_key

string

header

required

Body

application/json

V2ProspectLinkedinPostsEnrichRequest
V2ProspectLinkedinPostsEnrichRequest

Provide exactly one of prospect_ids or prospects_to_match; at most 50 entities.

prospect_ids

required

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

request_context

Request Context · object | null

Example:

null

parameters

LinkedInPostsEnrichmentParams · object

prospects_to_match

ProspectMatchInput · object[]

Match and enrich up to 50 prospects. Provide this or prospect_ids, never both.

Required array length: 1 - 50 elements

Show child attributes

Example:

[
  {
    "full_name": "Omer Har",
    "company_name": "Explorium"
  }
]

Response

Successful Response

V2ProspectEnrichResponse[LinkedinProspectsPostsOutputSchema]
V2ProspectMatchEnrichResponse[LinkedinProspectsPostsOutputSchema]

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

response_context

V2ResponseContext · object

required

Show child attributes

data

V2ProspectEnrichRow[LinkedinProspectsPostsOutputSchema] · object[]

required

Show child attributes

total_results

integer

required

Getting started

Businesses

Business enrichments

Prospects

Prospect enrichments

Research (GenAI)

Async jobs

Autocomplete

Credits

Events & Webhooks

Introduction

Enrich by prospect details instead of IDs

Body Params - Try Me Example

Authorizations

Body

Response

​Introduction

​Enrich by prospect details instead of IDs

​Body Params - Try Me Example

Authorizations

Body

Response

Introduction

Enrich by prospect details instead of IDs

Body Params - Try Me Example