Saltar al contenido

Referencia de herramientas

Upwork

Upwork. 19 herramientas, con sus parámetros y ejemplos de llamada.

Herramientas del agente de Upwork: ofertas públicas leídas, puntuadas y respondidas a partir de la base de conocimiento del workspace. No se envía nada a Upwork.

Cada llamada es una petición POST con la clave en Authorization: Bearer. El cuerpo JSON es la entrada de la herramienta, y la respuesta tiene la forma { "tool": "nom", "output": … }. Los ejemplos solo incluyen los parámetros obligatorios. Las descripciones de los parámetros son las que leen los agentes.

searchUpworkJobs#

Lee una página de resultados públicos (unas diez ofertas) y puntúa cada oferta frente a la base de conocimiento. Las ofertas se añaden al pipeline del workspace.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
qstringSíKeywords as a client would write them in a job post, e.g. 'next.js developer'
jobTypeany | hourly | fixedNo
hourlyMinintegerNoHourly rate floor in USD
hourlyMaxintegerNo
fixedMinintegerNoFixed-price budget floor in USD
fixedMaxintegerNo
experiencearray<entry | intermediate | expert>No
proposalsarray<0-4 | 5-9 | 10-14 | 15-19 | 20-49>NoKeep only jobs with this many proposals so far (less competition)
clientHiresarray<0 | 1-9 | 10+>No
pageintegerNo
scorebooleanNoScore each job against the knowledge base (judge capped at 12 per call)
persistbooleanNoAdd 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#

Lee una oferta: descripción, habilidades, presupuesto, actividad, cliente. Añade una instantánea fechada al pipeline.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
urlstringSí
scorebooleanNo
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#

Vuelve a puntuar las ofertas del pipeline tras un cambio en la base de conocimiento. No se lee ninguna página.

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

Tipo: Escritura. Scopes: write.

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

getUpworkRadar#

Radar de mercado: volumen por día, cuartiles de tarifa y presupuesto, habilidades, competencia, países de los clientes.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
searchobjectNo
curl -s https://piqline.com/api/v1/tools/getUpworkRadar \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkLeads#

Pipeline de Upwork: recuento por estado, mejores ofertas primero, resultado de cada una.

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

Tipo: Lectura. Scopes: read.

ParámetroTipoObligatorioDescripción
statusarray<new | shortlisted | drafted | submitted | viewed | replied | interview | won | …>No
minScoreintegerNo
limitintegerNo
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

updateUpworkLead#

Cambia el estado de una oferta del pipeline (enviada, respuesta, entrevista, ganada, perdida, ignorada) y guarda una nota.

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

Tipo: Escritura. Scopes: write.

ParámetroTipoObligatorioDescripción
jobIdstringSí
statusnew | shortlisted | drafted | submitted | viewed | replied | interview | won | …Sí
notestringNo
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#

Base de conocimiento de Upwork del workspace: servicios, herramientas, proyectos que evitar, tarifas mínimas, casos de estudio, tono, firma.

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

Tipo: Lectura. Scopes: read.

Esta herramienta no tiene parámetros: envía un cuerpo vacío, {}.

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

updateUpworkKnowledge#

Actualiza la base de conocimiento. Las listas que envías sustituyen a las listas almacenadas.

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

Tipo: Escritura. Scopes: write.

ParámetroTipoObligatorioDescripción
namestringNo
headlinestringNo
servicesarray<string>No
toolsarray<string>No
avoidarray<string>NoKinds of projects to never bid on, as short phrases or keywords
languagesarray<string>No
hourlyMinnumberNoLowest acceptable hourly rate, USD
fixedMinnumberNoLowest acceptable fixed budget, USD
freelancerCountrystringNo
caseStudiesarray<object>No
examplesarray<object>No
tonestringNo
signaturestringNo
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkTemplates#

Plantillas de propuesta guardadas, con sus campos y sus reglas de preguntas.

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

Tipo: Lectura. Scopes: read.

Esta herramienta no tiene parámetros: envía un cuerpo vacío, {}.

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

upsertUpworkTemplate#

Crea o actualiza una plantilla de propuesta.

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

Tipo: Escritura. Scopes: write.

ParámetroTipoObligatorioDescripción
idstringSíStable slug; reuse it to update
namestringSí
bodystringSíLiteral text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code.
questionRulesarray<object>No
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#

Redacta una propuesta para una oferta a partir de una plantilla. El texto lo pegas tú mismo en Upwork.

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

Tipo: Escritura. Scopes: write, explore.

ParámetroTipoObligatorioDescripción
urlstringNoUpwork job URL
jobIdstringNoJob id already in the pipeline, e.g. ~022113077029286601014
templateIdstringNoTemplate id or name; default = first saved template, else the built-in one
screeningQuestionsarray<string>NoScreening questions copied verbatim from the job
extraInstructionsstringNo
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

listUpworkCampaigns#

Campañas guardadas: búsqueda, puntuación mínima, estado, última actualización, estado de las fuentes.

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

Tipo: Lectura. Scopes: read.

Esta herramienta no tiene parámetros: envía un cuerpo vacío, {}.

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

saveUpworkCampaign#

Crea o actualiza una campaña: nombre, búsqueda, puntuación mínima, plantilla.

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

Tipo: Escritura. Scopes: write.

ParámetroTipoObligatorioDescripción
idstringNoStable slug; reuse it to update an existing campaign
namestringSí
searchobjectSí
minScoreintegerNo
templateIdstringNo
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#

Simula una campaña con ofertas reales antes de seguirla. No se guarda nada.

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

Tipo: Lectura en directo. Scopes: explore.

ParámetroTipoObligatorioDescripción
campaignIdstringNo
campaignobjectNo
pagesintegerNo
curl -s https://piqline.com/api/v1/tools/simulateUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

followUpworkCampaign#

Pide al Motor que siga una campaña guardada, a su ritmo de recogida.

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

Tipo: Acción. Scopes: act.

ParámetroTipoObligatorioDescripción
campaignIdstringSí
namestringNoNom 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#

Hace que el Motor deje de seguir una campaña. Las ofertas ya vistas permanecen en el pipeline.

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

Tipo: Acción. Scopes: act.

ParámetroTipoObligatorioDescripción
campaignIdstringSí
namestringNoNom 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#

Actualiza las campañas seguidas: fusiona las ofertas recogidas por el Motor, vuelve a leer la primera página en directo y puntúa las ofertas nuevas.

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

Tipo: Escritura. Scopes: write, explore.

ParámetroTipoObligatorioDescripción
campaignIdstringNo
livebooleanNo
curl -s https://piqline.com/api/v1/tools/refreshUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

checkUpworkOutcomes#

Vuelve a leer las páginas de las candidaturas en curso para fechar su resultado: cerrada, entrevistas iniciadas, sin respuesta.

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

Tipo: Escritura. Scopes: write, explore.

ParámetroTipoObligatorioDescripción
jobIdsarray<string>No
limitintegerNo
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

syncUpworkReplies#

Lee los correos de notificación de Upwork en las bandejas conectadas del creador de la clave y hace avanzar el estado de las ofertas del pipeline.

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

Tipo: Escritura. Scopes: write.

ParámetroTipoObligatorioDescripción
accountIdstringNo
limitintegerNo
curl -s https://piqline.com/api/v1/tools/syncUpworkReplies \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

¿Tienes una pregunta sobre la API o has encontrado un error en esta página? Escríbenos.