ツールリファレンス
LinkedIn。10 個のツールを、パラメーターと呼び出し例とともに掲載しています。
LinkedIn エージェントのツールです。公開投稿、企業ページ、広告をライブで読み取ります。連絡先は読み取りません。
各呼び出しは POST リクエストで、キーは Authorization: Bearer に入れます。JSON の本文がツールの入力で、レスポンスは { "tool": "nom", "output": … } の形式です。例には必須パラメーターだけを入れています。パラメーターの説明は、エージェントが読むものと同じです。
searchLinkedinPosts#
キーワードで公開投稿をリアルタイムに検索し、新しい順に返します(一部しか読めなかった場合は結果に明示されます)。求人の投稿には投稿者の肩書きとロールが付き、コードで算出したシグナルも付きます。採用、資金調達、ローンチ、拡大、組織再編、稼働可能、退職。
POSThttps://piqline.com/api/v1/tools/searchLinkedinPosts
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
query | string | はい | One exact phrase in double quotes as the post would say it, plus at most one or two plain words, e.g. '"je recrute" développeur'. No OR, no parentheses. |
datePosted | last-hour | last-day | last-week | last-month | last-year | いいえ | |
focus | all | people | hiring | signals | いいえ | people = only posts carrying a person pointer, hiring = hiring posts, signals = any signal |
moreQueries | array<string> | いいえ | Up to 3 other exact phrases searched together with query, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share depth. |
depth | integer | いいえ | Posts read at most, all formulas together: 15, 50, 100 or 200. One credit per post read. 15 for a quick look; 100 is the Auto value of a broad search. |
intent | string | いいえ | What sets the wanted posts apart, in the user's language: the job families or the topic, with a few concrete words, e.g. 'Métiers de la tech, de l'IT et de la vente : développeur, data, devops, produit, commercial, account executive, SDR'. Do NOT write what… |
relevance | wide | balanced | strict | いいえ | How close to intent a post must be: wide keeps more, strict keeps few. Ignored without intent. |
author | all | recruiter | founder | manager | いいえ | Keep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only. |
order | recent | closest | いいえ | recent = newest first; closest = closest in meaning to intent first. |
place | string | いいえ | Place the user cares about, e.g. 'France' or 'Lyon'. It weighs in the closeness score; it is not a hard filter. |
tuning | auto | manual | いいえ | auto = these values were chosen by you; the card sets manual when the user changed them. |
cursor | string | いいえ | nextCursor from a previous call |
curl -s https://piqline.com/api/v1/tools/searchLinkedinPosts \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"levée de fonds"}'const response = await fetch("https://piqline.com/api/v1/tools/searchLinkedinPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"query": "levée de fonds"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/searchLinkedinPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"query": "levée de fonds",
},
)
output = response.json()["output"]probeLinkedinWatch#
LinkedIn ウォッチを購読する前に、1〜3 個のクエリ案を試し、購読に添付する調査チケットを返します。
POSThttps://piqline.com/api/v1/tools/probeLinkedinWatch
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
intent | string | はい | User ask in natural language, e.g. « Suis les levées série A fintech chaque semaine » |
variants | array<object> | はい | Candidate keyword formulations as the market writes them |
detectionEvent | hiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | … | いいえ | |
detectionRounds | array<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …> | いいえ | |
detectionSectors | array<string> | いいえ | |
detectionGeos | array<string> | いいえ | |
detectionVocabulary | array<string> | いいえ |
curl -s https://piqline.com/api/v1/tools/probeLinkedinWatch \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"intent":"texte","variants":[{"query":"levée de fonds"}]}'const response = await fetch("https://piqline.com/api/v1/tools/probeLinkedinWatch", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"intent": "texte",
"variants": [
{
"query": "levée de fonds"
}
]
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/probeLinkedinWatch",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"intent": "texte",
"variants": [
{
"query": "levée de fonds",
},
],
},
)
output = response.json()["output"]getLinkedinPost#
公開投稿または記事を読み取ります。テキスト、投稿者、日付、リアクション、シグナル付きのコメント。
POSThttps://piqline.com/api/v1/tools/getLinkedinPost
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
url | string | はい | linkedin.com/posts/…, /feed/update/… or /pulse/… |
curl -s https://piqline.com/api/v1/tools/getLinkedinPost \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://exemple.fr/article"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinPost", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinPost",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]getLinkedinPostTranscript#
公開投稿の動画の文字起こし。存在する場合にのみ課金されます。
POSThttps://piqline.com/api/v1/tools/getLinkedinPostTranscript
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
url | string | はい | URL of the LinkedIn video post |
curl -s https://piqline.com/api/v1/tools/getLinkedinPostTranscript \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://exemple.fr/article"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinPostTranscript", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinPostTranscript",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]getLinkedinCompany#
公開された企業ページ。説明、従業員数、業種、資金調達、シグナル付きの最新投稿。
POSThttps://piqline.com/api/v1/tools/getLinkedinCompany
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
company | string | はい | URL linkedin.com/company/… ou handle (ex. shopify) |
curl -s https://piqline.com/api/v1/tools/getLinkedinCompany \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"texte"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinCompany", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"company": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinCompany",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"company": "texte",
},
)
output = response.json()["output"]getLinkedinCompanyPosts#
企業ページの過去の投稿と、シグナル(採用、資金調達、ローンチ)の要約。
POSThttps://piqline.com/api/v1/tools/getLinkedinCompanyPosts
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
company | string | はい | URL linkedin.com/company/… ou handle |
page | integer | いいえ |
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"company":"texte"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinCompanyPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"company": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinCompanyPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"company": "texte",
},
)
output = response.json()["output"]searchLinkedinAds#
広告ライブラリを検索します。広告主、フォーマット、日付、インプレッション。
POSThttps://piqline.com/api/v1/tools/searchLinkedinAds
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
company | string | いいえ | Nom d’entreprise, ex. Shopify |
companyId | string | いいえ | Id numérique LinkedIn de l’entreprise |
keyword | string | いいえ | Mot-clé secteur |
countries | string | いいえ | Codes pays ISO séparés par des virgules, ex. FR,ES |
startDate | string | いいえ | |
endDate | string | いいえ | |
paginationToken | string | いいえ |
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'const response = await fetch("https://piqline.com/api/v1/tools/searchLinkedinAds", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/searchLinkedinAds",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={},
)
output = response.json()["output"]getLinkedinAd#
ライブラリにある広告の詳細。ターゲティング、国別インプレッション、配信期間。
POSThttps://piqline.com/api/v1/tools/getLinkedinAd
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
url | string | はい | linkedin.com/ad-library/detail/… URL |
curl -s https://piqline.com/api/v1/tools/getLinkedinAd \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://exemple.fr/article"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinAd", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinAd",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
},
)
output = response.json()["output"]matchLinkedinPosts#
公開投稿をもとに、対応可能な人と案件を照合します(2 回の検索)。
POSThttps://piqline.com/api/v1/tools/matchLinkedinPosts
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
peopleQuery | string | はい | |
opportunityQuery | string | はい | |
datePosted | last-hour | last-day | last-week | last-month | last-year | いいえ | |
semantic | boolean | いいえ | Re-rank by closeness in meaning when available |
curl -s https://piqline.com/api/v1/tools/matchLinkedinPosts \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"peopleQuery":"texte","opportunityQuery":"texte"}'const response = await fetch("https://piqline.com/api/v1/tools/matchLinkedinPosts", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"peopleQuery": "texte",
"opportunityQuery": "texte"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/matchLinkedinPosts",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"peopleQuery": "texte",
"opportunityQuery": "texte",
},
)
output = response.json()["output"]getLinkedinProfile#
公開された /in/ プロフィールを、範囲を限って読み取ります。その人物に言及した公開投稿から辿る場合に限ります。このオプションを有効にしたワークスペース専用です。
POSThttps://piqline.com/api/v1/tools/getLinkedinProfile
種類: ライブ読み取り。スコープ: explore。
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
url | string | はい | linkedin.com/in/… URL from a pointer or pasted by the user |
basis | pointer | pasted | はい | |
postUrl | string | いいえ | Required with basis='pointer': the public post carrying the signal |
curl -s https://piqline.com/api/v1/tools/getLinkedinProfile \
-H "Authorization: Bearer $PIQLINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://exemple.fr/article","basis":"pointer"}'const response = await fetch("https://piqline.com/api/v1/tools/getLinkedinProfile", {
method: "POST",
headers: {
Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"url": "https://exemple.fr/article",
"basis": "pointer"
}),
});
const { output } = await response.json();import os
import requests
response = requests.post(
"https://piqline.com/api/v1/tools/getLinkedinProfile",
headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
json={
"url": "https://exemple.fr/article",
"basis": "pointer",
},
)
output = response.json()["output"]