---
title: "Get a quote"
method: POST
path: "/api/v1/quotes"
tags: ["Catalog"]
---

# Get a quote

`POST /api/v1/quotes`

## Request

- Base URL: `https://spoofy.social`
- URL: `https://spoofy.social/api/v1/quotes`
- Auth: none required

The exact price of a quantity. Nothing is charged and no auth is needed.

## Request body

- object
  - `service` integer, required
  - `quantity` integer
  - `link` string
  - `inputs` OrderInputs: Order fields, for services with `input.fields`. Text we post for you is checked first (see text_blocked).
    - `comments` union: Custom comments: one per line (or a list), each different. Their number is the quantity.
      - string[]
      - string
    - `usernames` union: Mentions: the accounts to mention, one per line (or a list), at most 50. Their number is the quantity.
      - string[]
      - string
    - `hashtag` string: Mentions by hashtag: one hashtag, e.g. "#yourbrand".
    - `username` string: An account (handle or profile link): whose followers get mentioned, whose comment gets the likes, or a subscription’s account.
    - `answer_number` integer: Poll votes: the option to vote for, 1 = the first (GET /api/v1/polls reads the options).
    - `runs` integer: Spread the order over this many runs; `quantity` is then per run and you pay for quantity × runs. Only where `input.spread` is true.
    - `interval` integer: Minutes between runs.
    - `min` integer: Subscriptions: the least each new post gets.
    - `max` integer: Subscriptions: the most each new post gets.
    - `posts` integer: Subscriptions: how many of your future posts it covers.
    - `old_posts` integer: Subscriptions: also this many of your latest posts.
    - `delay` 0 | 5 | 10 | 15 | 20 | 30 | 40 | 50 | 60 | 90 | 120 | 150 | 180 | 210 | 240 | 270 | 300 | 360 | 420 | 480 | 540 | 600: Subscriptions: minutes after a post goes up before it starts.
    - `expiry` string, date: Subscriptions: the last day (optional, up to a year ahead).

## Response `200`

The price.

- object
  - `quote` Quote
    - `service` integer
    - `quantity` integer: The units charged: the quantity (× runs), the comments or usernames sent, or max × posts.
    - `pricePer1k` string: Price per 1,000. USD as a decimal string.
    - `total` string: What the order costs. USD as a decimal string.
    - `currency` 'USD'

## Other responses

- `400`: Quantity outside the range.
- `404`: Unknown or paused service.
- `413`: The request body is too big (uploads up to 4 MB, everything else up to 64 KB).
- `429`: Slow down: too many requests in a short time. Wait `Retry-After` seconds and carry on.

---

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