V2 Businesses Linkedin Posts Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/linkedin_posts/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
]
}
'import requests
url = "https://api.explorium.ai/v2/businesses/linkedin_posts/enrich"
payload = { "business_ids": ["8adce3ca1cef0c986b22310e369a0793"] }
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({business_ids: ['8adce3ca1cef0c986b22310e369a0793']})
};
fetch('https://api.explorium.ai/v2/businesses/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/businesses/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([
'business_ids' => [
'8adce3ca1cef0c986b22310e369a0793'
]
]),
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/businesses/linkedin_posts/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\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/businesses/linkedin_posts/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/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 \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"business_id": "<string>",
"data": {
"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>"
}
]
}Sync
LinkedIn posts
POST
/
v2
/
businesses
/
linkedin_posts
/
enrich
V2 Businesses Linkedin Posts Enrich
curl --request POST \
--url https://api.explorium.ai/v2/businesses/linkedin_posts/enrich \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"business_ids": [
"8adce3ca1cef0c986b22310e369a0793"
]
}
'import requests
url = "https://api.explorium.ai/v2/businesses/linkedin_posts/enrich"
payload = { "business_ids": ["8adce3ca1cef0c986b22310e369a0793"] }
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({business_ids: ['8adce3ca1cef0c986b22310e369a0793']})
};
fetch('https://api.explorium.ai/v2/businesses/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/businesses/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([
'business_ids' => [
'8adce3ca1cef0c986b22310e369a0793'
]
]),
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/businesses/linkedin_posts/enrich"
payload := strings.NewReader("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\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/businesses/linkedin_posts/enrich")
.header("api_key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.explorium.ai/v2/businesses/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 \"business_ids\": [\n \"8adce3ca1cef0c986b22310e369a0793\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"response_context": {
"correlation_id": "<string>",
"request_status": "success",
"time_taken_in_seconds": 123
},
"data": [
{
"business_id": "<string>",
"data": {
"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>"
}
]
}Description
The Company’s Social Media Presence Enrichment endpoint provides insights into a company’s Social media activity, engagement trends, and posting behavior. This dataset is valuable for brand analysts, marketers, and business strategists looking to assess corporate communication trends and social media reach.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
business_id included in the request — whether or not results are returned. A request that returns no posts still consumes credits.- Volume of Social media posts over a given period.
- Engagement metrics, such as likes, shares, and comments.
- Trending topics and key themes in company communications.
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 company details instead of IDs
business_ids is the primary way to call this endpoint. If you don’t have Explorium IDs yet, you can send businesses_to_match instead: up to 50 companies, described with the same fields the Match businesses endpoint accepts (name, domain, url, linkedin_url). Each company is matched and enriched in the same call. Send either business_ids or businesses_to_match, never both (that returns a 422). Any parameters the endpoint takes work the same either way.
{
"businesses_to_match": [
{ "name": "Explorium", "domain": "explorium.ai" },
{ "name": "Unknown Co", "domain": "unknown-co.example" }
]
}
{
"response_context": {
"correlation_id": "ebe38f2b99ad423e84f93d2be5e75b20",
"request_status": "success",
"time_taken_in_seconds": 5.38
},
"data": [
{
"input": { "name": "Explorium", "domain": "explorium.ai", "url": null, "linkedin_url": null },
"business_id": "340c8040bd50cbab9c7df718bbe51cc9",
"data": { "business_id": "340c8040bd50cbab9c7df718bbe51cc9", "...": "same fields as an ID-based request" },
"warnings": []
},
{
"input": { "name": "Unknown Co", "domain": "unknown-co.example", "url": null, "linkedin_url": null },
"business_id": null,
"data": null,
"warnings": []
}
],
"total_results": 1,
"total_matches": 1
}
input and returns the matched business_id. Companies that don’t match come back with business_id: null and data: null, and aren’t charged. total_matches counts the matched rows.
How It Works
How It Works
- Input: Provide a
business_idobtained from the Match Businesses API. - Processing: The system retrieves Social media activity, post frequency, and engagement trends.
- Output: A structured response summarizing social media presence and key engagement metrics.
Credit Usage
Credit Usage
This endpoint uses a different charging model than other enrichment endpoints:
To avoid spending credits on IDs that are unlikely to return data, make sure you use valid business IDs retrieved from the Match Businesses endpoint.
| 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 business_id, regardless of whether results are returned. |
Best Practices
Best Practices
- Use social media insights to track brand perception and digital engagement trends.
- Analyze posting behavior to understand a company’s content strategy and outreach.
- Leverage engagement data to benchmark a company’s influence against competitors.
- Monitor trending topics to gain insights into corporate priorities and industry focus.
Company's Social Media Presence Output Signal
Company's Social Media Presence Output Signal
| SignalAPI | Name | Description | Data Type |
|---|---|---|---|
| post_text | Post text content | Text content of the LinkedIn® post published by company profile. | string |
| days_since_posted | Days since post | Number of days since the post was published by the company. | 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 company’s post by time of collection. | integer |
| number_of_likes | Number of post likes | Number of likes the company’s post received by time of collection. | integer |
| created_at | Time of posting | Timestamp of when the company’s post was published. | datetime |
- Credits are charged per requested
business_id, even when no results are returned — unlike other enrichment endpoints, which charge only for IDs that return data.
Body Params - Try Me Example
business_ids: 8adce3ca1cef0c986b22310e369a0793
Body
application/json
- V2BusinessLinkedinPostsEnrichRequest
- V2BusinessLinkedinPostsEnrichRequest
Provide exactly one of business_ids or businesses_to_match; at most 50 entities.
Response
Successful Response
- V2BusinessEnrichResponse[V2LinkedinCompaniesPostsOutputSchema]
- V2BusinessMatchEnrichResponse[V2LinkedinCompaniesPostsOutputSchema]
This is base response model for all responses in partner service.
Was this page helpful?