---
title: "Minimum and suggested bid for a query type (call before creating a query)"
method: GET
path: "/requestor/suggested-bid"
tags: ["Queries"]
---

# Minimum and suggested bid for a query type (call before creating a query)

`GET /requestor/suggested-bid`

## Request

- Base URL: `https://www.getabrain.ai/api/v1`
- URL: `https://www.getabrain.ai/api/v1/requestor/suggested-bid`
- Auth: one of:
  - API key in header `X-API-Key` and API key in header `X-API-Secret`
  - HTTP bearer

min_bid_cents is the effort-priced floor the API enforces for this type; suggested_bid_cents is a fair default (1.5x the floor). percentiles summarise recently-answered queries of the same type when there is enough data.

## Query parameters

- `type` 'text' | 'multiple_choice' | 'rating_scale' | 'image_comparison' | 'ranking' | 'yes_no' | 'sentiment' | 'image_selection' | 'free_form_text' | 'video_review' | 'audio_review' | 'image_analysis' | 'ab_test' | 'voice_capture' | 'video_capture' | 'photo_capture', required
- `days` integer

## Response `200`

Bid guidance

- object
  - `type` string
  - `days` integer
  - `sample_size` integer
  - `min_bid_cents` integer: Enforced floor for this type
  - `suggested_bid_cents` integer
  - `percentiles` object, nullable
    - `min_cents` integer
    - `p25_cents` integer
    - `p50_cents` integer
    - `p75_cents` integer
    - `p90_cents` integer
    - `max_cents` integer
  - `message` string

## Other responses

- `400`: Request failed validation
- `401`: Missing or invalid authentication

---

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