GET /api/domains

Request	`GET /api/domains`
Authentication	Session cookie required
Handler	`backend/domain_market.py`

What it does

With a query it quotes that domain; without one it suggests up to ten for the resolved product. `markup` is served rather than folded into the price, so the price the founder pays and the margin taken on it are separately visible.

Authentication

Session cookie required. Send the ff_session cookie. Without one the engine treats the caller as a new visitor with no holds and no claims, and returns a new cookie to use from then on.

Parameters

Parameter	In	Type	Required	Description
`ff_session`	cookie	`string`	Optional	The session identifier. Omit it on the first call and store the value the response sets; every later call must send the same one or the engine treats the caller as a new visitor with no holds and no claims.
`q`	query	`string`	Optional	A specific domain to quote. Omit for suggestions.

Request

The cookie jar carries the session between calls. Angle-bracketed values are the parameter types from the table above.

cURLJavaScriptPython

curl -s -b cookies.txt -c cookies.txt \
  "https://flowfinds.ai/api/domains"

const res = await fetch("https://flowfinds.ai/api/domains", {
  method: "GET",
  credentials: "include",
});
const data = await res.json();

import requests

s = requests.Session()
r = s.get("https://flowfinds.ai/api/domains")
data = r.json()

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  "$FLOWFINDS_ORIGIN/api/domains?q=example.com"

Responses

`200` — Quotes or suggestions were produced.

Field	Type	Description
`status`	`string`	`ok`.
`account`	`string`	The account the quotes are for.
`product_id`	`string`	The product the suggestions were derived from.
`domains`	`array`	Rows carrying the domain name and `price_eur`.
`owned`	`array`	Domains this account already holds.
`markup`	`number`	The multiplier applied over the registrar price — 1.5.

Errors

Status	Reason	When
`401`	—	The session has no account.

GET /api/store — The state of the session's storefront.
POST /api/store — Start generating the storefront for the session's product.
POST /api/store/publish — Verify and publish the storefront, regenerating it if verification demands.
POST /api/intent — Ask the engine what it would change on a surface, and why.
POST /api/intent/apply — Apply a proposed intent, regenerating the store.
POST /api/intent/order — Override the section the storefront leads with.
POST /api/intent/revert — Undo the last applied intent.
POST /api/ai/edit — Edit the storefront in natural language.

Back to the API reference index, or read the cookbook for recipes that compose this endpoint with others.