---
title: "Agrégation d'offres d'emploi publiques pour inférer les tendances de recrutement. Trois modes : (1) company_hiring — ana"
method: POST
path: "/api/v1/call/job_postings_intelligence"
tags: ["expertise"]
---

# Agrégation d'offres d'emploi publiques pour inférer les tendances de recrutement. Trois modes : (1) company_hiring — ana

`POST /api/v1/call/job_postings_intelligence`

## Request

- Base URL: `https://mcp.gapup.io`
- URL: `https://mcp.gapup.io/api/v1/call/job_postings_intelligence`
- Auth: HTTP bearer

Agrégation d'offres d'emploi publiques pour inférer les tendances de recrutement. Trois modes : (1) company_hiring — analyse des postings d'une société : volume, fonctions (engineering/sales/marketing/ops/finance/hr), seniorité, géographie, croissance vs période précédente, signaux stratégiques inférés ; (2) role_market — volume marché global pour un rôle (open positions estimate, top employeurs, compétences demandées, médiane seniorité) ; (3) competitor_hiring_comparison — comparaison multi-sociétés (total postings, growth%, focus areas). Sources : Adzuna (ADZUNA_APP_ID/KEY env), RemoteOK (keyless), Himalayas (keyless), baseline statique 40 top employeurs. Usages : due diligence VC, intelligence compétitive, benchmarks RH, signaux pivots stratégiques. Cache 6h. SLA ≤15s.

## Request body

- object
  - `mode` 'company_hiring' | 'role_market' | 'competitor_hiring_comparison', required: Mode d'analyse : 'company_hiring' | 'role_market' | 'competitor_hiring_comparison'
  - `company` string: Nom de la société (pour company_hiring ou comme 1er concurrent)
  - `role` string: Intitulé de poste à analyser (pour role_market, ex. 'data scientist', 'compliance officer')
  - `location` string: Pays ou ville (ex. 'France', 'United States', 'London')
  - `competitors` string[]: Liste de sociétés à comparer (pour competitor_hiring_comparison, min 2)
  - `period_days` number: Fenêtre d'analyse en jours (défaut 30)
  - `async` boolean: If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts.

## Response `200`

Tool result

- object
  - `tool` string
  - `result` object
    - `mode` string, required
    - `company_hiring` object
      - `company` string
      - `period_days` number
      - `total_postings` number
      - `by_function` object
      - `by_seniority` object
      - `by_location` object
      - `growth_pct_vs_prior_period` number
      - `inferred_hiring_focus` string[]
      - `inferred_signals` object[]
    - `role_market` object
      - `role` string
      - `location` string
      - `open_positions_estimate` number
      - `top_employers` object[]
      - `median_seniority` string
      - `skills_demanded` object[]
    - `competitor_comparison` object[]
      - `company` string
      - `total_postings` number
      - `growth_pct` number
      - `focus_areas` string[]
    - `sources` object[], required
      - `name` string, required
      - `url` string, required
      - `status` string, required
    - `quality_score` number, required
    - `status` 'partial' | 'final' | 'failed', required
  - `request_id` string
  - `source` 'rest-api'
  - `ms` number

## Other responses

- `400`: Invalid arguments
- `401`: Unauthorized
- `402`: Payment Required — pay via x402 (USDC on Base) then retry with X-Payment header
- `404`: Tool not found
- `429`: Rate limited
- `500`: Internal error

---

[API](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api.md) · [All operations](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gapup/apis/gapup-mcp-rest-api/revisions/afb9da3b98f4?raw)