Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: HortOS buyer API (Australia) Search API
version: '1'
summary: Search wholesale growers' live stock lists and price a whole plant list, Australia.
description: 'HortOS is Australia''s live wholesale plant market. This API answers two questions with the same data the site shows: who lists a plant (and from what trade price), and what a whole plant list costs from growers near a job. Prices are AUD, ex GST, set by each grower. NOTHING HERE PLACES AN ORDER: pricing a list returns quote_url, a page a person opens, checks and sends; each grower then confirms stock and freight. No key is needed. Please keep use to what a person would ask for; heavy use is slowed down (HTTP 429, or 503 when the pricing engine is busy). Trade only.'
termsOfService: https://au.hortosapp.com/terms
contact:
name: HortOS
url: https://au.hortosapp.com/ai
servers:
- url: https://au.hortosapp.com
description: Australia
tags:
- name: Search
paths:
/api/v1/search:
get:
operationId: searchPlants
summary: Who lists a plant, in which pot sizes, and from what trade price
parameters:
- name: q
in: query
required: true
description: Plant name, botanical or common. Rough spelling is fine.
schema:
type: string
minLength: 2
maxLength: 120
example: lomandra tanika
- name: state
in: query
required: false
description: Limit to growers in one state (its code).
schema:
type: string
pattern: ^[A-Za-z]{2,3}$
- name: size
in: query
required: false
description: Limit to one pot size, e.g. 140mm, 45L or Tube.
schema:
type: string
maxLength: 24
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 30
default: 12
responses:
'200':
description: Matching plants
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResult'
'400':
description: The query was too short
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too many searches from this address
tags:
- Search
components:
schemas:
Error:
type: object
properties:
error:
type: string
SearchResult:
type: object
properties:
query:
type: string
currency:
type: string
prices:
type: string
description: How prices are quoted, e.g. ex GST
search_url:
type: string
format: uri
results:
type: array
items:
type: object
properties:
plant:
type: string
common_name:
type:
- string
- 'null'
growers:
type: integer
description: Growers listing the plant right now
price_from_ex_tax:
type:
- number
- 'null'
price_to_ex_tax:
type:
- number
- 'null'
sizes:
type: array
items:
type: string
url:
type: string
format: uri
externalDocs:
description: How to use HortOS from an AI assistant or your own software
url: https://au.hortosapp.com/ai