v1
public

List Public Propellers

Unauthenticated curated-propeller list, paged and licensed like /motors.

Carries the same datasheet an authenticated caller reads. A propeller's per-station geometry (radius, chord, twist, thickness, section airfoils) is not part of that datasheet and is returned by no endpoint, under any filter or ordering.

Numeric fields are filterable with bracket syntax — ?kv[gte]=900&kv[lte]=1100 — and the bounds are inclusive. Discrete fields take [in] with a comma-separated list — ?brand[in]=T-Motor,Hobbywing. A bracket filter naming a field this type does not have is a 400 unknown_filter listing the fields it does have, so a typo cannot quietly return the whole catalog.

Carries license because there is no bulk export: a consumer reading the open database page by page has to learn the terms from the response, and this is the only place left that can tell it.

get/v1/public/propellers

Request

  • Base URL: https://thrustlab.com
  • URL: https://thrustlab.com/v1/public/propellers
  • Auth: none required

Query parameters

limitinteger
starting_afterstring nullable

Where the next page starts — the next_starting_after the previous page returned. Under the default ordering (sort_by=name, sort_order=asc) that is the last component's id, and a component id is accepted under any ordering. Under any other ordering it is an opaque cursor bound to that sort_by/sort_order, and replaying it against a different ordering is a 400 invalid_cursor. Omit for the first page.

searchstring nullable

Case-insensitive substring match on the component name.

qstring nullable

Alias for search. If both are supplied, search wins. Length-capped identically.

brandstring[] nullable

Restrict to these brands. Repeat the parameter for several (?brand=T-Motor&brand=Hobbywing). brand[in]=a,b does the same.

sort_bystring

Sort key. name (the default) on every type, plus — motor: R (or resistance), iq_max (or current_max), kv, n (or poles), weight; battery: c_rating, energy_density, series_cells, total_capacity_mAh (or capacity), weight_g (or weight); propeller: diameter, inertia, maxRPM (or max_rpm), num_blades, pd_ratio, pitch, weight. Either spelling of a field works, here and in the bracket filters. pd_ratio is a propeller's pitch divided by its diameter; energy_density is a pack's NOMINAL specific energy in Wh/kg (capacity x 3.7 V per cell x series cells / mass), a label figure for ranking packs against each other, not a measurement.

sort_orderstring

asc or desc.

Response

Successful Response

has_moreboolean required

True when a further page exists; page with starting_after.

licensestring required

The licence this data is published under. Stated on the response because there is no bulk export to carry it.

next_starting_afterstring nullable

Pass as starting_after to fetch the next page. Null on the last page, so a client can loop until it disappears. Under the default ordering it is the last component's id; under any other ordering it is an opaque cursor bound to that sort.

object'list'

Changes

No recorded changes to this operation across all 1 revision of this API.