Profile Views and Reactions
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/linkedin/profile-view \
--header 'Content-Type: application/json' \
--data '
{
"account_id": "<string>",
"identifier": "<string>",
"notify": true,
"post_id": "<string>",
"reaction_type": "<string>"
}
'import requests
url = "https://win.oneshotagent.com/v1/tools/linkedin/profile-view"
payload = {
"account_id": "<string>",
"identifier": "<string>",
"notify": True,
"post_id": "<string>",
"reaction_type": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
account_id: '<string>',
identifier: '<string>',
notify: true,
post_id: '<string>',
reaction_type: '<string>'
})
};
fetch('https://win.oneshotagent.com/v1/tools/linkedin/profile-view', 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://win.oneshotagent.com/v1/tools/linkedin/profile-view",
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([
'account_id' => '<string>',
'identifier' => '<string>',
'notify' => true,
'post_id' => '<string>',
'reaction_type' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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://win.oneshotagent.com/v1/tools/linkedin/profile-view"
payload := strings.NewReader("{\n \"account_id\": \"<string>\",\n \"identifier\": \"<string>\",\n \"notify\": true,\n \"post_id\": \"<string>\",\n \"reaction_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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://win.oneshotagent.com/v1/tools/linkedin/profile-view")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"<string>\",\n \"identifier\": \"<string>\",\n \"notify\": true,\n \"post_id\": \"<string>\",\n \"reaction_type\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/linkedin/profile-view")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"<string>\",\n \"identifier\": \"<string>\",\n \"notify\": true,\n \"post_id\": \"<string>\",\n \"reaction_type\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyLinkedIn
Profile Views and Reactions
View a profile or react to a post through a connected account that granted view_profile / react.
POST
/
v1
/
tools
/
linkedin
/
profile-view
Profile Views and Reactions
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/linkedin/profile-view \
--header 'Content-Type: application/json' \
--data '
{
"account_id": "<string>",
"identifier": "<string>",
"notify": true,
"post_id": "<string>",
"reaction_type": "<string>"
}
'import requests
url = "https://win.oneshotagent.com/v1/tools/linkedin/profile-view"
payload = {
"account_id": "<string>",
"identifier": "<string>",
"notify": True,
"post_id": "<string>",
"reaction_type": "<string>"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
account_id: '<string>',
identifier: '<string>',
notify: true,
post_id: '<string>',
reaction_type: '<string>'
})
};
fetch('https://win.oneshotagent.com/v1/tools/linkedin/profile-view', 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://win.oneshotagent.com/v1/tools/linkedin/profile-view",
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([
'account_id' => '<string>',
'identifier' => '<string>',
'notify' => true,
'post_id' => '<string>',
'reaction_type' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$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://win.oneshotagent.com/v1/tools/linkedin/profile-view"
payload := strings.NewReader("{\n \"account_id\": \"<string>\",\n \"identifier\": \"<string>\",\n \"notify\": true,\n \"post_id\": \"<string>\",\n \"reaction_type\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
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://win.oneshotagent.com/v1/tools/linkedin/profile-view")
.header("Content-Type", "application/json")
.body("{\n \"account_id\": \"<string>\",\n \"identifier\": \"<string>\",\n \"notify\": true,\n \"post_id\": \"<string>\",\n \"reaction_type\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/linkedin/profile-view")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_id\": \"<string>\",\n \"identifier\": \"<string>\",\n \"notify\": true,\n \"post_id\": \"<string>\",\n \"reaction_type\": \"<string>\"\n}"
response = http.request(request)
puts response.read_bodyTwo paid, idempotent engagement actions: view a profile, or react to a post. Both share the contract of Reply: fixed price per action,
Result (job
The summary contains only public-safe fields: no contact info, no pictures. Views count toward LinkedIn’s guidance of roughly 100 profile retrievals per account per day, whether or not they notify. OneShot’s default cap is 100/day (
Default cap 50/day (
Idempotency-Key required, synchronous rejections before payment, per-account daily caps with randomized spacing (paced separately from replies), and the worker’s grant check at execution time.
Settlement. A 202 means the action was accepted and charged, and the worker then runs it. If the job fails before anything reaches LinkedIn (grant changed, account disconnected at execution, cap re-check), the failed-job sweep refunds the receipt as agent credit. An action that reached sending or completed stays charged.
Profile view
POST /v1/tools/linkedin/profile-view. Requires the view_profile grant.
string
required
Connected LinkedIn account id.
string
required
The target’s public identifier (
jane-doe), provider id, or a linkedin.com/in/<slug> URL (normalized to the slug).boolean
default:"false"
false is a data read. true shows the human in the target’s “who viewed your profile”, a visible signal that cannot be undone.completed):
{
"action_request_id": "…", "action": "view_profile", "status": "sent",
"profile": {
"provider_id": "…", "public_identifier": "jane-doe", "name": "Jane Doe",
"headline": "CTO at …", "location": "Austin, Texas", "network_distance": "DISTANCE_2", "is_open_profile": null
}
}
LINKEDIN_DAILY_PROFILE_VIEW_CAP).
Reaction
POST /v1/tools/linkedin/react. Requires the react grant.
string
required
Connected LinkedIn account id.
string
required
The post’s LinkedIn social id, e.g.
urn:li:activity:7100000000000000000 or urn:li:ugcPost:….string
default:"like"
like · celebrate · support · love · insightful · funny.LINKEDIN_DAILY_REACTION_CAP). “Already reacted” is treated as success. The human can remove reactions on LinkedIn, but this API cannot.
Failure semantics (different from reply on purpose)
Engagement retries; reply does not. Viewing a profile twice or re-sending the same reaction is idempotent upstream, so a timeout or 5xx is retried immediately (at most two attempts), then fails withprovider_unavailable. There is no ambiguous state and no reconciliation. Other codes: grant_revoked, account_disconnected, target_not_found, content_rejected, rate_limited, account_send_limit.
Response and errors
Same 202 shape as Reply (withaction set to view_profile / react and no conversation_id), and the same pre-payment error table minus the conversation-specific codes.
Examples
const view = await agent.linkedinViewProfile({ accountId, identifier: 'https://www.linkedin.com/in/jane-doe/', notify: true, memo: 'warm-up before outreach' });
console.log(view.profile.headline);
await agent.linkedinReact({ accountId, postId: 'urn:li:activity:7100000000000000000', reactionType: 'insightful', memo: 'engage with prospect post' });
client.linkedin_view_profile(account_id, "jane-doe", notify=True)
client.linkedin_react(account_id, "urn:li:activity:7100000000000000000", reaction_type="celebrate")