Piloterr

Welcome to the Jungle Search

GET
/v2/welcometothejungle/search

Search Welcome to the Jungle jobs. Returns offer cards and pagination (1 credit).

Credit cost: 1 credit per call

Autorización

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

Job keyword or a Welcome to the Jungle jobs-search URL.

Example (keyword):

python

Example (jobs URL):

https://www.welcometothejungle.com/fr/jobs?query=python

Notes:

  • language defaults to fr. en, en-GB and en-US use the English index.
  • A company profile URL (/companies/{slug} without a jobs search) returns 400.
  • Another host returns 400.
language?string

fr (default) or en. en-gb and en-us count as en. A /fr/ or /en/ path in the URL overrides this.

Default"fr"
page?number

Page from 1, 30 offers. A page value already in the URL overrides this.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/welcometothejungle/search?query=string'
Example Response
{  "results": [    {      "url": "https://www.welcometothejungle.com/fr/companies/warren-walter/jobs/developpeur-senior-python-node-js-ia-llm-rag-machine-learning-freelance-h-f_paris",      "city": "Paris",      "slug": "developpeur-senior-python-node-js-ia-llm-rag-machine-learning-freelance-h-f_paris",      "title": "Développeur Senior Python / Node.js – IA, LLM, RAG & Machine Learning Freelance (H/F)",      "remote": "partial",      "company": {        "name": "Warren Walter",        "slug": "warren-walter",        "logo_url": "https://cdn-images.welcometothejungle.com/fvPxjAqiAdHkDVgw0Wv2mGh7J1agohB0wDryhKh1vog/rs:auto:400/q:85/czM6Ly93dHRqLXByb2R1Y3Rpb24vdXBsb2Fkcy9vcmdhbml6YXRpb24vbG9nby81NzY3LzE2NDg4MS9kZjlmMzY5MS0xNTZmLTQwYTItOWRjMC0xOGQ5NGM1YjUwMTIucG5n",        "reference": "9onX3U"      },      "country": "FR",      "sectors": [        "Application mobile",        "Logiciels",        "Digital Marketing / Data Marketing",        "IT / Digital"      ],      "position": 1,      "reference": "51c6ad1d-9fe0-431e-9c42-566fef3a08f2",      "profession": "Développeur de logiciels",      "salary_max": 550,      "salary_min": 450,      "published_at": "2026-10-26T09:49:08Z",      "contract_type": "freelance",      "salary_period": "daily",      "salary_currency": "EUR"    }  ],  "pagination": {    "next": "https://www.welcometothejungle.com/fr/jobs?query=python&page=2",    "page": 1,    "per_page": 30,    "total_pages": 34,    "total_results": 6712  }}