💼 Wellfound Jobs API: Una API de empleos en startups para datos salariales y de equity

Una API de empleos en startups para Wellfound (anteriormente AngelList Talent). Busca por rol, ubicación y estado remoto, y obtén una fila JSON limpia por cada empleo: la descripción completa, los rangos salariales y de equity analizados, y las señales de la startup contratante, incluyendo respaldo de Y Combinator, inversores principales y etapa de financiación.

Actor: https://apify.com/johnvc/wellfound-jobs-api?fpr=9n7kx3

Video explicativo

Explicación textual

Esta API de empleos convierte los listados públicos de startups de Wellfound en datos estructurados. Le proporcionas roles (slugs de Wellfound como software-engineer, o palabras simples como "software" y "pm", que se asignan automáticamente) y opcionalmente locations como san-francisco, new-york o london. Cada par de rol y ubicación se convierte en su propia búsqueda, y la API recorre los resultados paginados por ti.

Cada fila devuelve title, url, la description completa en markdown y la compensación analizada en números reales: salaryMin, salaryMax, salaryCurrency, equityMin y equityMax. El objeto company adjunto incluye name, size, tagline, stage y las insignias que publica Wellfound, para que puedas quedarte solo con empleos remotos en startups, solo empleos en startups de YC o solo empresas que están contratando activamente.

Un caso de uso concreto: configura remoteOnly con minSalary para crear un feed semanal de empleos remotos en startups por encima de un salario mínimo, luego activa fetchJobDetails para añadir beneficios, industria, el sitio web de la empresa y coordenadas geográficas para la lista corta que te interesa.

Inicio rápido

Requisitos previos

• Python 3.11 o superior

• uv para la gestión de paquetes

• Un token de API de Apify. Obtén tu clave API gratuita en https://apify.com?fpr=9n7kx3

git clone https://github.com/johnisanerd/Apify-Wellfound-Jobs-API.git
cd Apify-Wellfound-Jobs-API
uv sync
cp .env.example .env       # then paste your token into .env
uv run python wellfound-jobs-api-example.py

Alternativa: establecer la clave API directamente

export APIFY_API_TOKEN="your_apify_api_token_here"
uv run python wellfound-jobs-api-example.py

¿Por qué usar esta API de empleos de Wellfound?

• Descripciones completas incluidas. La descripción completa del empleo aparece en la fila del listado, no detrás de una solicitud adicional.

• Salario y equity como números. Wellfound publica la remuneración como una cadena tipo $135k - $175k * 0.05% - 0.25%. Esta API la analiza en salaryMin, salaryMax, equityMin y equityMax para que puedas ordenar y filtrar.

• Señales de startups que puedes filtrar. ycOnly, topInvestorsOnly, activelyHiringOnly y companyStage provienen directamente de las insignias que muestra Wellfound.

• Paga solo por lo que obtienes. La facturación es por empleo entregado, con cargos pequeños separados por la descripción y por el enriquecimiento opcional de detalles. Los empleos eliminados por tus filtros nunca se cobran.

Funcionalidades

Capacidades principales

• Búsqueda por rol, ubicación y estado remoto, con paginación automática

• Entrada de roles en texto libre asignada a slugs reales de Wellfound ("software" a software-engineer)

• Filtros de inclusión y exclusión de palabras clave sobre título, descripción, empresa y ubicación

• Filtros de salario, equity, tipo de empleo y experiencia

• Filtros de señales de startups: Y Combinator, inversores principales, contratación activa, etapa de financiación

• Enriquecimiento opcional de detalles: beneficios, industria, sitio web de la empresa, geolocalización, salario estructurado

• Pega cualquier URL de búsqueda de Wellfound directamente con startUrls

Calidad de los datos

• Una fila por empleo, desduplicada en todos los hilos de búsqueda de la ejecución

• Marcas de tiempo ISO de cuándo se publicó cada empleo

• Las ejecuciones que no devuelven nada explican el motivo en el conjunto de datos, no solo en el registro

Ejemplos de uso

Ejemplo básico

run_input = {"roles": ["software-engineer"], "maxItems": 5}

Empleos remotos en startups

run_input = {"roles": ["software-engineer"], "remoteOnly": True, "maxItems": 25}

Empleos en startups de YC por más de $150k

run_input = {
    "roles": ["software-engineer"],
    "ycOnly": True,
    "minSalary": 150000,
    "maxItems": 25,
}

Empleos en startups en una ciudad, con enriquecimiento

run_input = {
    "roles": ["software-engineer"],
    "locations": ["san-francisco"],
    "fetchJobDetails": True,
    "maxItems": 10,
}

Parámetros de entrada

Formato de salida

{
  "result_type": "job",
  "id": "4353862",
  "title": "Product Manager",
  "url": "https://wellfound.com/jobs/4353862-product-manager",
  "description": "### About the role ...",
  "compensationRaw": "$130k - $200k * 0.15% - 0.25%",
  "salaryMin": 130000,
  "salaryMax": 200000,
  "salaryCurrency": "USD",
  "equityMin": 0.15,
  "equityMax": 0.25,
  "jobType": "full-time",
  "remote": false,
  "remoteKind": "ONSITE",
  "locationNames": ["San Francisco"],
  "postedAt": "2026-07-28T20:58:57+00:00",
  "company": {
    "name": "Agave API",
    "slug": "agave-api",
    "size": "SIZE_11_50",
    "tagline": "Unified API for construction software",
    "stage": "early_stage",
    "ycFunded": true,
    "topInvestors": true,
    "activelyHiring": true
  }
}

Con fetchJobDetails habilitado, las filas también incluyen benefits, industry, companyWebsite, geo, detailSalary y applicantLocationRequirements.

Programarlo

Guarda una tarea con tu búsqueda y luego adjunta un programa para crear un historial de nuevas publicaciones. Cadenas cron útiles: 0 7 * * * para diario a las 7 AM, 0 6 * * 1 para los lunes.

La gente también busca

¿Cómo obtengo datos de empleos en startups como API? Ejecuta este Actor desde Python, la API de Apify o cualquier cliente MCP. Devuelve JSON, CSV o Excel.

¿Cómo encuentro empleos remotos en startups? Establece remoteOnly a true. Las filas incluyen remote, remoteKind y acceptedRemoteLocationNames.

¿Cómo encuentro empleos en startups de Y Combinator? Establece ycOnly a true, o filtra por topInvestorsOnly y companyStage.

¿Puedo obtener empleos en startups para una ciudad específica? Sí. Combina roles con locations como san-francisco, new-york o london.

¿Incluye salario y equity? Sí, tanto como texto sin procesar como analizados en rangos numéricos.

¿Wellfound es gratuito para quienes buscan empleo? Sí. Esta API lee las mismas páginas públicas que ve un visitante y las devuelve como datos estructurados.

Instalar en Claude Cowork Desktop

Cowork es el modo de automatización de la aplicación de escritorio. Para darle la API de empleos de Wellfound como herramienta, añade el servidor MCP de Apify como conector.

1. Abre la aplicación de escritorio de Claude y ve a Settings → Connectors (o Settings → Developer → Edit Config para editar claude_desktop_config.json directamente).

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añade el servidor MCP de Apify, precargado solo con este Actor:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"
      ]
    }
  }
}

3. Reinicia la aplicación. Cuando Cowork llame a la herramienta por primera vez, completa el aviso de OAuth en tu navegador, o añade tu token de API de Apify en la configuración del conector para omitir OAuth.

4. En un chat de Cowork, confirma que la herramienta está disponible y pídele que ejecute la API de empleos de Wellfound.

Descarga la aplicación de escritorio y comienza una prueba gratuita: https://claude.ai/referral/uIlpa7nPLg Más ayuda: https://docs.apify.com/platform/integrations/claude-desktop

Instalar en Claude Code

Claude Code es la herramienta de línea de comandos. Añade el servidor MCP del Actor con un solo comando:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"

Para usar un token en lugar de OAuth en el navegador:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

Luego verifica con claude mcp list, o ejecuta /mcp dentro de una sesión. Pide a Claude Code que llame a la API de empleos de Wellfound.

Prueba Claude Code gratis: https://claude.ai/referral/uIlpa7nPLg Documentación de MCP de Claude Code: https://code.claude.com/docs/en/mcp

Instalar en Claude (sitio web)

En claude.ai añades Apify como conector, luego habilitas solo la herramienta de este Actor.

1. Ve a Settings → Connectors → Browse connectors y busca Apify MCP server. Instálalo (habilita o actualiza si se solicita).

2. Al conectar, autentícate con tu token de API de Apify y habilita la herramienta johnvc/wellfound-jobs-api.

3. En cualquier chat, abre + → Connectors y activa Apify.

4. Alternativamente, elige Add custom connector y pega la URL MCP completa https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api, usando OAuth cuando se solicite.

5. Pide a Claude que ejecute la API de empleos de Wellfound.

Abre Claude en la web: https://claude.ai/referral/uIlpa7nPLg

Instalar en Cursor

Cursor lee los servidores MCP desde un archivo de proyecto en .cursor/mcp.json.

1. En tu proyecto, crea .cursor/mcp.json:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api"
    }
  }
}

2. Si prefieres autenticación por token en lugar de OAuth en el navegador, añade un encabezado:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Abre Cursor → Settings → MCP y confirma que el servidor apify está conectado (punto verde).

4. En Composer o Chat, pide a Cursor que llame a la API de empleos de Wellfound.

¿Nuevo en Cursor? Consíguelo aquí: https://cursor.com/referral?code=XQP4VBLI3NNX

Instalar en ChatGPT

ChatGPT se conecta al servidor MCP de Apify a través del modo Desarrollador (disponible en los planes ChatGPT Pro, Plus, Business, Enterprise y Education).

1. Haz clic en tu icono de perfil y luego ve a Configuración > Apps. Si no ves un botón Crear app, abre Configuración avanzada y activa Modo desarrollador.

2. Haz clic en Crear app y completa el formulario:

   • Nombre: Apify

   • URL del servidor MCP: https://mcp.apify.com/?tools=actors,docs,johnvc/wellfound-jobs-api

   • Autenticación: OAuth

3. Haz clic en Crear y autoriza la conexión con Apify.

4. Para usar la app en una conversación, haz clic en + en el chat, elige Modo desarrollador y selecciona Apify.

Más ayuda: https://docs.apify.com/platform/integrations/mcp

Hecho con cuidado

Usa la API de Wellfound Jobs para potenciar tus flujos de trabajo de reclutamiento, investigación de mercado y generación de leads con resultados confiables y estructurados.

Última actualización: 2026.08.18