---
title: "Api Estimate"
method: POST
path: "/api/estimate"
tags: ["jobs"]
---

# Api Estimate

`POST /api/estimate`

## Request

- Base URL: `https://outsend.xyz`
- URL: `https://outsend.xyz/api/estimate`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Calcule le coût d'un job potentiel sans le créer.
Utilisé par le frontend pour afficher la barre EF en live.

## Request body

- JobEstimateRequest: Pour le calcul live d'EF côté frontend (sans création).
  - `queries` string[]
  - `zones` string[]
  - `country` string
  - `include_reviews` boolean
  - `scrap_mode` 'fast' | 'normal' | 'ultra'
  - `stop_at` integer, nullable

## Response `200`

Successful Response

- JobEstimateResponse
  - `valid` boolean, required
  - `grid_points` integer, required
  - `total_requests` integer
  - `queries_count` integer
  - `ef_cost` number, required
  - `ef_max` number
  - `estimated_duration_seconds` integer, nullable
  - `errors` string[]
  - `warnings` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outsend/apis/outsend-api.md) · [All operations](https://skmtc.dev/outsend/apis/outsend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outsend/apis/outsend-api/revisions/39db3c6f886a?raw)