API de Upwork
Busca proyectos y profesionales independientes en Upwork con filtros propios para cada lado del mercado. Presupuesto, tarifa, experiencia y ubicación proceden de perfiles públicos.
La coincidencia o distintivo no garantiza identidad, disponibilidad o idoneidad del objeto observado. La API no presenta propuestas, contrata, paga ni accede a conversaciones del proyecto.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Upwork, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar proyectos en Upworksearch | Busca proyectos de Upwork mediante keyword, con exclusiones, tipo, fechas u orden opcionales. | $1.39 por 1.000 solicitudes | Normal |
Buscar profesionales independientesfreelancers | Busca profesionales por la habilidad indicada en keyword, con continente (region, no un país) y filtro Top Rated opcionales. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Upwork?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar proyectos en Upwork Busca proyectos de Upwork mediante | keyword | exclude_keywords, experience_level, job_type, since, sort, until | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · title · text · budget · budget_currency · hourly_rate_min · hourly_rate_max · job_type · experience_level · engagement_type · duration · proposals · persons_to_hire · posted_at · tags · client_name · client_location · client_rating · client_review_count · client_total_spent · client_hire_rate · client_avg_hourly_rate · payment_verified · email · emails · phone · platform |
freelancersBuscar profesionales independientes Busca profesionales por la habilidad indicada en | keyword | region, top_rated | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · url · name · title · text · location · region · timezone · hourly_rate · currency · job_success_score · total_earnings · total_jobs · total_hours · total_hourly_jobs · total_fixed_jobs · is_top_rated · is_top_rated_plus · is_vetted · is_available · skills · image_url · platform |
¿Qué significan los parámetros de Upwork search?
Busca proyectos de Upwork mediante keyword, con exclusiones, tipo, fechas u orden opcionales. Devuelve presupuesto, tarifa y experiencia solicitada; no presenta propuestas ni garantiza adjudicación.
keywordObligatorio- En
search, busca trabajos de externalización; enfreelancers, busca talentos. El mismo término de habilidad corresponde a la demanda en una acción y a la oferta en la otra. exclude_keywordsOpcional- Palabras clave de trabajos a excluir en
search. No es una lista negra de talentos ni un requisito mínimo de habilidades. experience_levelOpcional- Nivel de experiencia del puesto:
entry_level,intermediate_leveloexpert_level.Valores permitidos:entry_levelexpert_levelintermediate_level job_typeOpcional- Tipo de facturación del contrato para
search:hourly(por horas) ofixed_price(importe fijo). No se refiere a si es de tiempo completo o parcial.Valores permitidos:fixed_pricehourlyUpwork: contrato por horas y contrato de precio fijo — Upwork diferencia el cobro por tiempo de los proyectos con importe o hitos acordados. `job_type` clasifica la oferta; esta API no incluye registro de horas, escrow, contratación ni gestión de hitos. · Consultada sinceOpcional- Fecha de inicio de publicación del trabajo para
search. No es la fecha de registro del empleador. sortOpcional- Orden de los trabajos para
search:newest(más reciente),oldest(más antiguo) orelevance(relevancia). No se garantiza queoldestse aplique en todos los casos.Valores permitidos:newestoldestrelevance untilOpcional- Fecha de fin de publicación del trabajo para
search. Se usa en conjunto consince. No es la fecha de finalización del contrato.
¿Qué significan los parámetros de Upwork freelancers?
Busca profesionales por la habilidad indicada en keyword, con continente (region, no un país) y filtro Top Rated opcionales. Devuelve ubicación, tarifa, Job Success Score, ingresos y perfil públicos; no verifica disponibilidad, identidad ni idoneidad para contratar.
keywordObligatorio- En
search, busca trabajos de externalización; enfreelancers, busca talentos. El mismo término de habilidad corresponde a la demanda en una acción y a la oferta en la otra. regionOpcional- Continente donde se encuentra el profesional:
africa,americas,asia,europeuoceania. No acepta códigos de país comoUS.Valores permitidos:africaamericasasiaeuropeoceania top_ratedOpcional- Para obtener solo talentos «Top Rated» en
freelancers, usa el valor booleanotrueofalse. Por defecto, no se aplica filtro. La cadena de texto"false"también se interpretará comotrue, así que no uses cadenas de texto.Upwork: el JSS y las insignias de talento no son el mismo campo — Upwork describe el `JSS` (Job Success Score) como un indicador de rendimiento que combina la satisfacción del cliente, los resultados de los contratos y las relaciones a largo plazo, y lo usa como uno de los requisitos para ciertas insignias de talento. El `JSS` no es lo mismo que la puntuación por estrellas, y la insignia `Top Rated` no implica una garantía sobre la calidad del proyecto. · Consultada
Cómo usar la API de Upwork
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"upwork","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Upwork
¿Cómo llamo a la API de Upwork?
Envía POST /api/v1/social con platform igual a upwork, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Upwork?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, budget y budget_currency. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Upwork?
Upwork diferencia el cobro por tiempo de los proyectos con importe o hitos acordados. job_type clasifica la oferta; esta API no incluye registro de horas, escrow, contratación ni gestión de hitos.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; freelancers requiere keyword.
¿Las acciones de Upwork responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.