Zum Inhalt springen

Tool-Referenz

Upwork

Upwork. 19 Tools, mit ihren Parametern und Aufrufbeispielen.

Tools des Upwork-Agenten: öffentliche Jobs lesen, bewerten und anhand der Wissensbasis des Workspace beantworten. An Upwork wird nichts gesendet.

Jeder Aufruf ist eine POST-Anfrage mit dem Schlüssel in Authorization: Bearer. Der JSON-Body ist die Eingabe des Tools, und die Antwort hat die Form { "tool": "nom", "output": … }. Die Beispiele enthalten nur die erforderlichen Parameter. Die Parameterbeschreibungen sind die, die die Agenten lesen.

searchUpworkJobs#

Liest eine Seite öffentlicher Ergebnisse (etwa zehn Jobs) und bewertet jeden Job anhand der Wissensbasis. Die Jobs werden der Pipeline des Workspace hinzugefügt.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
qstringJaKeywords as a client would write them in a job post, e.g. 'next.js developer'
jobTypeany | hourly | fixedNein
hourlyMinintegerNeinHourly rate floor in USD
hourlyMaxintegerNein
fixedMinintegerNeinFixed-price budget floor in USD
fixedMaxintegerNein
experiencearray<entry | intermediate | expert>Nein
proposalsarray<0-4 | 5-9 | 10-14 | 15-19 | 20-49>NeinKeep only jobs with this many proposals so far (less competition)
clientHiresarray<0 | 1-9 | 10+>Nein
pageintegerNein
scorebooleanNeinScore each job against the knowledge base (judge capped at 12 per call)
persistbooleanNeinAdd 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#

Liest einen Job: Beschreibung, Skills, Budget, Aktivität, Kunde. Fügt der Pipeline einen datierten Snapshot hinzu.

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

Typ: Live-Lesen. Scopes: explore.

ParameterTypErforderlichBeschreibung
urlstringJa
scorebooleanNein
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#

Bewertet die Jobs der Pipeline nach einer Änderung der Wissensbasis erneut. Es wird keine Seite gelesen.

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

Typ: Schreiben. Scopes: write.

ParameterTypErforderlichBeschreibung
jobIdsarray<string>Ja
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobIds":["texte"]}'

getUpworkRadar#

Marktradar: Volumen pro Tag, Quartile von Satz und Budget, Skills, Wettbewerb, Länder der Kunden.

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

Typ: Live-Lesen. Scopes: explore.

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

listUpworkLeads#

Upwork-Pipeline: Anzahl pro Status, beste Jobs zuerst, Ergebnis jedes Jobs.

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

Typ: Lesen. Scopes: read.

ParameterTypErforderlichBeschreibung
statusarray<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …>Nein
minScoreintegerNein
limitintegerNein
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkLead#

Ändert den Status eines Jobs der Pipeline (gesendet, Antwort, Gespräch, gewonnen, verloren, ignoriert) und behält eine Notiz.

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

Typ: Schreiben. Scopes: write.

ParameterTypErforderlichBeschreibung
jobIdstringJa
statusnew | shortlisted | drafted | submitted | viewed | replied | interview | won | …Ja
notestringNein
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-Wissensbasis des Workspace: Leistungen, Werkzeuge, zu meidende Projekte, Mindestsätze, Fallstudien, Tonalität, Signatur.

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

Typ: Lesen. Scopes: read.

Dieses Tool nimmt keine Parameter: Senden Sie einen leeren Body, {}.

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

updateUpworkKnowledge#

Aktualisiert die Wissensbasis. Von Ihnen gesendete Listen ersetzen die gespeicherten Listen.

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

Typ: Schreiben. Scopes: write.

ParameterTypErforderlichBeschreibung
namestringNein
headlinestringNein
servicesarray<string>Nein
toolsarray<string>Nein
avoidarray<string>NeinKinds of projects to never bid on, as short phrases or keywords
languagesarray<string>Nein
hourlyMinnumberNeinLowest acceptable hourly rate, USD
fixedMinnumberNeinLowest acceptable fixed budget, USD
freelancerCountrystringNein
caseStudiesarray<object>Nein
examplesarray<object>Nein
tonestringNein
signaturestringNein
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkTemplates#

Gespeicherte Angebotsvorlagen, mit ihren Slots und ihren Fragenregeln.

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

Typ: Lesen. Scopes: read.

Dieses Tool nimmt keine Parameter: Senden Sie einen leeren Body, {}.

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

upsertUpworkTemplate#

Erstellt oder aktualisiert eine Angebotsvorlage.

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

Typ: Schreiben. Scopes: write.

ParameterTypErforderlichBeschreibung
idstringJaStable slug; reuse it to update
namestringJa
bodystringJaLiteral text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code.
questionRulesarray<object>Nein
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#

Entwirft ein Angebot für einen Job anhand einer Vorlage. Den Text fügen Sie selbst auf Upwork ein.

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

Typ: Schreiben. Scopes: write, explore.

ParameterTypErforderlichBeschreibung
urlstringNeinUpwork job URL
jobIdstringNeinJob id already in the pipeline, e.g. ~022113077029286601014
templateIdstringNeinTemplate id or name; default = first saved template, else the built-in one
screeningQuestionsarray<string>NeinScreening questions copied verbatim from the job
extraInstructionsstringNein
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkCampaigns#

Gespeicherte Kampagnen: Suche, Mindestscore, Status, letzte Aktualisierung, Zustand der Quellen.

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

Typ: Lesen. Scopes: read.

Dieses Tool nimmt keine Parameter: Senden Sie einen leeren Body, {}.

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

saveUpworkCampaign#

Erstellt oder aktualisiert eine Kampagne: Name, Suche, Mindestscore, Vorlage.

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

Typ: Schreiben. Scopes: write.

ParameterTypErforderlichBeschreibung
idstringNeinStable slug; reuse it to update an existing campaign
namestringJa
searchobjectJa
minScoreintegerNein
templateIdstringNein
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#

Simuliert eine Kampagne an echten Jobs, bevor Sie ihr folgen. Nichts wird gespeichert.

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

Typ: Live-Lesen. Scopes: explore.

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

followUpworkCampaign#

Bittet den Motor, einer gespeicherten Kampagne in ihrem Erfassungsrhythmus zu folgen.

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

Typ: Aktion. Scopes: act.

ParameterTypErforderlichBeschreibung
campaignIdstringJa
namestringNeinNom 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#

Hält den Motor davon ab, einer Kampagne zu folgen. Bereits gesehene Jobs bleiben in der Pipeline.

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

Typ: Aktion. Scopes: act.

ParameterTypErforderlichBeschreibung
campaignIdstringJa
namestringNeinNom 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#

Aktualisiert die verfolgten Kampagnen: führt die vom Motor erfassten Jobs zusammen, liest die erste Seite erneut live und bewertet die neuen Jobs.

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

Typ: Schreiben. Scopes: write, explore.

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

checkUpworkOutcomes#

Liest die Seiten laufender Bewerbungen erneut, um ihr Ergebnis zu datieren: geschlossen, Gespräche begonnen, keine Antwort.

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

Typ: Schreiben. Scopes: write, explore.

ParameterTypErforderlichBeschreibung
jobIdsarray<string>Nein
limitintegerNein
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

syncUpworkReplies#

Liest die Benachrichtigungs-E-Mails von Upwork in den verbundenen Postfächern des Schlüsselerstellers und setzt den Status von Pipeline-Jobs weiter.

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

Typ: Schreiben. Scopes: write.

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

Eine Frage zur API oder ein Fehler auf dieser Seite? Schreiben Sie uns.