본문으로 건너뛰기

도구 레퍼런스

LinkedIn

LinkedIn. 도구 10개와 매개변수, 호출 예제.

LinkedIn 에이전트의 도구입니다. 공개 게시물, 회사 페이지, 광고를 실시간으로 읽습니다. 연락처는 읽지 않습니다.

각 호출은 Authorization: Bearer에 키를 넣은 POST 요청입니다. JSON 본문이 도구의 입력이며, 응답은 { "tool": "nom", "output": … } 형태입니다. 예제에는 필수 매개변수만 포함되어 있습니다. 매개변수 설명은 에이전트가 읽는 설명과 같습니다.

searchLinkedinPosts#

키워드로 공개 게시물을 실시간으로 최신순 검색합니다(부분 읽기는 결과에 표시됨). 채용 게시물에는 작성자의 직함과 역할을 함께 반환하며, 코드가 계산한 신호(채용, 투자 유치, 출시, 확장, 조직 개편, 가용, 퇴사)를 포함합니다.

POSThttps://piqline.com/api/v1/tools/searchLinkedinPosts

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
querystring예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.
datePostedlast-hour | last-day | last-week | last-month | last-year아니요
focusall | people | hiring | signals아니요people = only posts carrying a person pointer, hiring = hiring posts, signals = any signal
moreQueriesarray<string>아니요Up to 3 other exact phrases searched together with query, same writing rule, e.g. ['"nous recrutons"', '"on recrute"']. They share depth.
depthinteger아니요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.
intentstring아니요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…
relevancewide | balanced | strict아니요How close to intent a post must be: wide keeps more, strict keeps few. Ignored without intent.
authorall | recruiter | founder | manager아니요Keep only posts whose author's title reads as recruiter, founder or manager. Titles exist on hiring posts only.
orderrecent | closest아니요recent = newest first; closest = closest in meaning to intent first.
placestring아니요Place the user cares about, e.g. 'France' or 'Lyon'. It weighs in the closeness score; it is not a hard filter.
tuningauto | manual아니요auto = these values were chosen by you; the card sets manual when the user changed them.
cursorstring아니요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"}'

probeLinkedinWatch#

LinkedIn 모니터링을 구독하기 전에 쿼리 변형 1~3개를 시험하고, 구독에 첨부할 조사 티켓을 반환합니다.

POSThttps://piqline.com/api/v1/tools/probeLinkedinWatch

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
intentstring예User ask in natural language, e.g. « Suis les levées série A fintech chaque semaine »
variantsarray<object>예Candidate keyword formulations as the market writes them
detectionEventhiring | funding | launch | expansion | reorg | open_to_work | leaving | interested_comment | …아니요
detectionRoundsarray<pre_seed | seed | series_a | series_b | series_c | series_d | bridge | extension | …>아니요
detectionSectorsarray<string>아니요
detectionGeosarray<string>아니요
detectionVocabularyarray<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"}]}'

getLinkedinPost#

공개 게시물 또는 기사를 읽습니다: 텍스트, 작성자, 날짜, 반응, 신호가 포함된 댓글.

POSThttps://piqline.com/api/v1/tools/getLinkedinPost

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
urlstring예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"}'

getLinkedinPostTranscript#

공개 게시물 동영상의 전사. 전사가 있는 경우에만 과금됩니다.

POSThttps://piqline.com/api/v1/tools/getLinkedinPostTranscript

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
urlstring예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"}'

getLinkedinCompany#

공개 회사 페이지: 설명, 직원 수, 업종, 투자 정보, 신호가 포함된 최신 게시물.

POSThttps://piqline.com/api/v1/tools/getLinkedinCompany

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
companystring예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"}'

getLinkedinCompanyPosts#

회사 페이지의 이전 게시물과 신호 요약(채용, 투자, 출시).

POSThttps://piqline.com/api/v1/tools/getLinkedinCompanyPosts

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
companystring예URL linkedin.com/company/… ou handle
pageinteger아니요
curl -s https://piqline.com/api/v1/tools/getLinkedinCompanyPosts \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company":"texte"}'

searchLinkedinAds#

광고 라이브러리를 검색합니다: 광고주, 형식, 날짜, 노출 수.

POSThttps://piqline.com/api/v1/tools/searchLinkedinAds

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
companystring아니요Nom d’entreprise, ex. Shopify
companyIdstring아니요Id numérique LinkedIn de l’entreprise
keywordstring아니요Mot-clé secteur
countriesstring아니요Codes pays ISO séparés par des virgules, ex. FR,ES
startDatestring아니요
endDatestring아니요
paginationTokenstring아니요
curl -s https://piqline.com/api/v1/tools/searchLinkedinAds \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

getLinkedinAd#

라이브러리 광고의 상세: 타겟팅, 국가별 노출 수, 게재 기간.

POSThttps://piqline.com/api/v1/tools/getLinkedinAd

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
urlstring예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"}'

matchLinkedinPosts#

공개 게시물을 바탕으로 가용한 사람과 기회를 매칭합니다(검색 두 번).

POSThttps://piqline.com/api/v1/tools/matchLinkedinPosts

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
peopleQuerystring예
opportunityQuerystring예
datePostedlast-hour | last-day | last-week | last-month | last-year아니요
semanticboolean아니요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"}'

getLinkedinProfile#

공개 /in/ 프로필을 제한적으로 읽습니다. 그 사람을 언급하는 공개 게시물에서만 가능합니다. 이 옵션을 켠 워크스페이스 전용입니다.

POSThttps://piqline.com/api/v1/tools/getLinkedinProfile

유형: 실시간 읽기. 스코프: explore.

매개변수형식필수설명
urlstring예linkedin.com/in/… URL from a pointer or pasted by the user
basispointer | pasted예
postUrlstring아니요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"}'

API에 대한 질문이 있거나 이 페이지에 오류가 있나요? 문의하기.