本文へスキップ

ツールリファレンス

Upwork

Upwork。19 個のツールを、パラメーターと呼び出し例とともに掲載しています。

Upwork エージェントのツールです。公開された案件を読み取り、スコアを付け、ワークスペースのナレッジベースをもとに回答を作成します。Upwork には何も送信しません。

各呼び出しは POST リクエストで、キーは Authorization: Bearer に入れます。JSON の本文がツールの入力で、レスポンスは { "tool": "nom", "output": … } の形式です。例には必須パラメーターだけを入れています。パラメーターの説明は、エージェントが読むものと同じです。

searchUpworkJobs#

公開結果の 1 ページ(約 10 件の案件)を読み取り、ナレッジベースに照らして各案件にスコアを付けます。案件はワークスペースのパイプラインに追加されます。

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

種類: ライブ読み取り。スコープ: explore。

パラメーター型必須説明
qstringはいKeywords as a client would write them in a job post, e.g. 'next.js developer'
jobTypeany | hourly | fixedいいえ
hourlyMinintegerいいえHourly rate floor in USD
hourlyMaxintegerいいえ
fixedMinintegerいいえFixed-price budget floor in USD
fixedMaxintegerいいえ
experiencearray<entry | intermediate | expert>いいえ
proposalsarray<0-4 | 5-9 | 10-14 | 15-19 | 20-49>いいえKeep only jobs with this many proposals so far (less competition)
clientHiresarray<0 | 1-9 | 10+>いいえ
pageintegerいいえ
scorebooleanいいえScore each job against the knowledge base (judge capped at 12 per call)
persistbooleanいいえAdd the jobs to the workspace pipeline (upwork_pipeline)
curl -s https://piqline.com/api/v1/tools/searchUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"levée de fonds"}'

getUpworkJob#

案件を読み取ります。説明、スキル、予算、アクティビティ、クライアント。日付付きのスナップショットをパイプラインに追加します。

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

種類: ライブ読み取り。スコープ: explore。

パラメーター型必須説明
urlstringはい
scorebooleanいいえ
curl -s https://piqline.com/api/v1/tools/getUpworkJob \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'

scoreUpworkJobs#

ナレッジベースを変更した後に、パイプラインの案件を再スコアリングします。ページは読み取りません。

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

種類: 書き込み。スコープ: write。

パラメーター型必須説明
jobIdsarray<string>はい
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobIds":["texte"]}'

getUpworkRadar#

市場レーダー。日ごとの件数、単価と予算の四分位、スキル、競合状況、クライアントの国。

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

種類: ライブ読み取り。スコープ: explore。

パラメーター型必須説明
searchobjectいいえ
curl -s https://piqline.com/api/v1/tools/getUpworkRadar \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkLeads#

Upwork のパイプライン。ステータスごとの件数、上位の案件、各案件の結果。

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

種類: 読み取り。スコープ: read。

パラメーター型必須説明
statusarray<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …>いいえ
minScoreintegerいいえ
limitintegerいいえ
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkLead#

パイプラインの案件のステータス(送信済み、返信、面談、受注、失注、無視)を変更し、メモを残します。

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

種類: 書き込み。スコープ: write。

パラメーター型必須説明
jobIdstringはい
statusnew | shortlisted | drafted | submitted | viewed | replied | interview | won | …はい
notestringいいえ
curl -s https://piqline.com/api/v1/tools/updateUpworkLead \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","status":"new"}'

getUpworkKnowledge#

ワークスペースの Upwork ナレッジベース。サービス、ツール、避けたい案件、最低単価、事例、トーン、署名。

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

種類: 読み取り。スコープ: read。

このツールにパラメーターはありません。空の本文 {} を送信してください。

curl -s https://piqline.com/api/v1/tools/getUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkKnowledge#

ナレッジベースを更新します。送信したリストは、保存済みのリストを置き換えます。

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

種類: 書き込み。スコープ: write。

パラメーター型必須説明
namestringいいえ
headlinestringいいえ
servicesarray<string>いいえ
toolsarray<string>いいえ
avoidarray<string>いいえKinds of projects to never bid on, as short phrases or keywords
languagesarray<string>いいえ
hourlyMinnumberいいえLowest acceptable hourly rate, USD
fixedMinnumberいいえLowest acceptable fixed budget, USD
freelancerCountrystringいいえ
caseStudiesarray<object>いいえ
examplesarray<object>いいえ
tonestringいいえ
signaturestringいいえ
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkTemplates#

保存済みの提案テンプレート。スロットと質問ルール付き。

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

種類: 読み取り。スコープ: read。

このツールにパラメーターはありません。空の本文 {} を送信してください。

curl -s https://piqline.com/api/v1/tools/listUpworkTemplates \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

upsertUpworkTemplate#

提案テンプレートを作成または更新します。

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

種類: 書き込み。スコープ: write。

パラメーター型必須説明
idstringはいStable slug; reuse it to update
namestringはい
bodystringはいLiteral text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code.
questionRulesarray<object>いいえ
curl -s https://piqline.com/api/v1/tools/upsertUpworkTemplate \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","name":"texte","body":"texte"}'

draftUpworkProposal#

テンプレートをもとに、案件への提案文を下書きします。Upwork へは自分で貼り付けます。

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

種類: 書き込み。スコープ: write, explore。

パラメーター型必須説明
urlstringいいえUpwork job URL
jobIdstringいいえJob id already in the pipeline, e.g. ~022113077029286601014
templateIdstringいいえTemplate id or name; default = first saved template, else the built-in one
screeningQuestionsarray<string>いいえScreening questions copied verbatim from the job
extraInstructionsstringいいえ
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkCampaigns#

保存済みのキャンペーン。検索、最低スコア、ステータス、最終更新、ソースの状態。

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

種類: 読み取り。スコープ: read。

このツールにパラメーターはありません。空の本文 {} を送信してください。

curl -s https://piqline.com/api/v1/tools/listUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

saveUpworkCampaign#

キャンペーンを作成または更新します。名前、検索、最低スコア、テンプレート。

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

種類: 書き込み。スコープ: write。

パラメーター型必須説明
idstringいいえStable slug; reuse it to update an existing campaign
namestringはい
searchobjectはい
minScoreintegerいいえ
templateIdstringいいえ
curl -s https://piqline.com/api/v1/tools/saveUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"texte","search":{"q":"levée de fonds"}}'

simulateUpworkCampaign#

追跡を始める前に、実際の案件でキャンペーンをシミュレーションします。何も保存しません。

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

種類: ライブ読み取り。スコープ: explore。

パラメーター型必須説明
campaignIdstringいいえ
campaignobjectいいえ
pagesintegerいいえ
curl -s https://piqline.com/api/v1/tools/simulateUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

followUpworkCampaign#

保存済みのキャンペーンを、その収集ペースで追跡するよう Motor に依頼します。

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

種類: アクション。スコープ: act。

パラメーター型必須説明
campaignIdstringはい
namestringいいえNom de la campagne, pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/followUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

pauseUpworkCampaign#

Motor によるキャンペーンの追跡を止めます。すでに確認した案件はパイプラインに残ります。

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

種類: アクション。スコープ: act。

パラメーター型必須説明
campaignIdstringはい
namestringいいえNom de la campagne, pour la carte de confirmation.
curl -s https://piqline.com/api/v1/tools/pauseUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'

refreshUpworkCampaigns#

追跡中のキャンペーンを更新します。Motor が収集した案件を統合し、最初のページをライブで再度読み取り、新しい案件にスコアを付けます。

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

種類: 書き込み。スコープ: write, explore。

パラメーター型必須説明
campaignIdstringいいえ
livebooleanいいえ
curl -s https://piqline.com/api/v1/tools/refreshUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

checkUpworkOutcomes#

進行中の応募のページを再度読み取り、結果の日付を記録します。クローズ、面談の開始、返信なし。

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

種類: 書き込み。スコープ: write, explore。

パラメーター型必須説明
jobIdsarray<string>いいえ
limitintegerいいえ
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

syncUpworkReplies#

キー作成者の接続済み受信トレイにある Upwork の通知メールを読み取り、パイプラインの案件のステータスを進めます。

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

種類: 書き込み。スコープ: write。

パラメーター型必須説明
accountIdstringいいえ
limitintegerいいえ
curl -s https://piqline.com/api/v1/tools/syncUpworkReplies \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

API についてのご質問や、このページの誤りはありませんか。 お問い合わせ.