---
title: "Search the web and optionally read result pages with Firecrawl (MPP)"
method: POST
path: "/v1/mpp/firecrawl/search"
tags: ["Proxy"]
---

# Search the web and optionally read result pages with Firecrawl (MPP)

`POST /v1/mpp/firecrawl/search`

## Request

- Base URL: `https://api.munition.io`
- URL: `https://api.munition.io/v1/mpp/firecrawl/search`
- Auth: none required

Munition Firecrawl Search over MPP: Search the web and optionally read result pages with Firecrawl. Pay 0.03 USDC per call on Base/Polygon/Arbitrum via Authorization: Payment (stablecoin-only EIP-3009 charge authorization). Same input, output and failure policy as POST /v1/firecrawl/search.

## Headers

- `Idempotency-Key` string

## Request body

- FirecrawlSearchInput
  - `query` string, required
  - `limit` integer
  - `lang` string: Language code, e.g. en, fr.
  - `country` string: Two-letter country code, e.g. us, fr.
  - `tbs` string: Time filter, e.g. qdr:d (day), qdr:w (week), qdr:m (month).
  - `scrapeContent` boolean: Also scrape each result to markdown.

## Response `200`

Successful response

- FirecrawlSearchOutput
  - `query` string, required
  - `results` object[], required
    - `url` string, uri, required
    - `title` string, nullable
    - `description` string, nullable
    - `markdown` string, nullable: Present when scrapeContent is true.
  - `meta` object, required
    - `resultCount` integer, required
    - `searchedAt` string, date-time, required

## Other responses

- `400`: Invalid input on an authorized request; rejected before the MPP payment is settled.
- `402`: Call without Authorization to receive an MPP challenge, then retry with Authorization: Payment <credential>. Invalid payment and settlement failures can also return 402.
- `409`: Idempotency conflict; do not pay again
- `422`: Upstream provider rejected the request after settlement (client-side error); payment is kept, paidCallId returned for reconciliation.
- `502`: Upstream provider failed after settlement; payment is kept, paidCallId returned for reconciliation.
- `503`: MPP settlement in progress or ambiguous; retry with the same Authorization, Idempotency-Key and body. Do not pay again.

---

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