# Start a pitch report

> Scan a company that isn't a client yet. Reads their website, works out what they sell and to whom, and runs one scan; the report is ready a few minutes later from the pitch endpoint. Spends one of the month's pitch reports — 402 when the plan has none left. The prospect is never billed as a client.

Source: https://getintel.ai/docs/api/reference/operations/createpitch/

## POST /pitches

`POST https://app.getintel.ai/api/v1/pitches`

### Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `brand_id` | query | no | integer | The brand to read, from GET /brands. Required when the account has more than one brand. |
| `url` | query | yes | string | The prospect's website, e.g. acme.com. |
| `market_code` | query | no | string | Where to ask the engines from, e.g. GB-en or GB. Default: whatever their site reads as. |

### Responses

- **200**: OK
- **400**: Invalid parameter, or brand_id missing on a multi-brand account (brand_required). (`Error`)
- **401**: Missing, revoked or unknown API key (invalid_api_key). (`Error`)
- **403**: The plan doesn't include this data (feature_not_in_plan) or the plan isn't active (plan_inactive). (`Error`)
- **404**: The brand or the requested item doesn't exist (brand_not_found, not_found). (`Error`)
- **409**: The integration this needs isn't connected (integration_not_connected). (`Error`)
- **429**: Monthly read limit reached (quota_exceeded) or more than 60 requests a minute (rate_limited). (`Error`)
- **502**: An upstream service failed; retry later (upstream_error). (`Error`)