API REFERENCE

Three endpoints. One decision.

Bearer authentication with a project-scoped key, a required idempotency key on writes, and a pinned response contract. The full machine-readable document is published as OpenAPI.

ENDPOINTS

Create or reuse a bounded Next Move scan

Submits a public product URL and returns either a ready founder-reviewed move or an accepted job you poll. Reuse is idempotent: the same Idempotency-Key with the same input returns the same scan.

REQUIRED HEADERS

AuthorizationBearer <project-scoped API key>REQUIRED
Idempotency-KeyUnique per distinct requestREQUIRED
Content-Typeapplication/jsonREQUIRED

POST /v1/next-move

curl -X POST "https://trendsfast.com/v1/next-move" \
  -H "Authorization: Bearer $TRENDSFAST_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"https://yourproduct.com",
       "objective":"Grow among technical founders",
       "generation_level":"brief"}'

RESPONSES

200A fresh founder-reviewed result is ready
202Bounded work is queued, running, or awaiting review
400The Idempotency-Key header is missing or invalid
401The bearer API key is missing, invalid, or revoked
403The key lacks write scope or cannot access the project
409The idempotency key was already used for a different request
413The request body exceeds the bounded API limit
422The JSON body does not match the Next Move request contract
429The key's request, provider-cost, or Founder usage limit was reached
500The request failed without exposing internal details
503Provider work or its private operating policy is disabled

REQUEST BODY

What you send.

NEXT MOVE REQUEST FIELDS
Field	Type	Required	Note
product_url	string (url)	REQUIRED	A public product page.
objective	string	OPTIONAL	What you are trying to grow.
preferred_channels	string[]	OPTIONAL	Channels you can use.
content_capabilities	string[]	OPTIONAL	Formats you can credibly make.
generation_level	enum	OPTIONAL	How much drafting the move carries.

OPERATING RULES

Things worth knowing.

Idempotency is required

Writes require an Idempotency-Key. The same key with the same input returns the same scan; reusing it with different input returns 409.

Polling is free

A 202 gives you a scan you can poll with GET /v1/next-moves/{id}. Polling does not consume a research run.

Results are private

A scan is visible only to the key that created it. Results are never published, and public sharing is a separate opt-in after delivery.

Get a key Read the docs