# PartLark

> A free catalogue for finding maker electronics and comparing marketplace listings. No sponsored listings (see /ethics).

Browse parts and variants, compare listed goods prices, and follow seller or Superbuy links. Prices and availability can change; shipping, taxes and fees may be additional. Check the listing and variant before ordering.

## Pages

- [Catalogue](https://partlark.xyz/): Search and browse maker parts.
- [How it works](https://partlark.xyz/how-it-works): How to find and order a part.
- [Our ethics](https://partlark.xyz/ethics): Independence, pricing and funding policy.
- [Why PartLark](https://partlark.xyz/why-use): Comparing listings and planning a haul.
- [FAQ](https://partlark.xyz/faq): Short answers on prices, fees, ordering, accuracy and shipping ([Markdown version](https://partlark.xyz/faq.md)).
- [Blog](https://partlark.xyz/blog): Guides and notes on sourcing maker electronics.
- [Product sitemap](https://partlark.xyz/sitemap.xml): Published product URLs.

## Categories

Top-level categories; each page links to its sub-categories.

- [Sensors](https://partlark.xyz/?category=sensors): 1005 parts.
- [Components](https://partlark.xyz/?category=components): 910 parts.
- [Development boards](https://partlark.xyz/?category=development-boards): 648 parts.
- [Accessories](https://partlark.xyz/?category=accessories): 590 parts.
- [Motors & drivers](https://partlark.xyz/?category=motor-drivers): 478 parts.
- [Displays](https://partlark.xyz/?category=displays): 440 parts.
- [Connectors & headers](https://partlark.xyz/?category=connectors): 427 parts.
- [Interface modules](https://partlark.xyz/?category=interface): 329 parts.
- [Kits & assortments](https://partlark.xyz/?category=kits): 310 parts.
- [Cables & adapters](https://partlark.xyz/?category=cables): 292 parts.
- [Power & charging](https://partlark.xyz/?category=power): 214 parts.
- [LEDs & lighting](https://partlark.xyz/?category=leds): 203 parts.
- [Other maker parts](https://partlark.xyz/?category=other): 164 parts.
- [Wireless & radio](https://partlark.xyz/?category=wireless): 153 parts.
- [Audio](https://partlark.xyz/?category=audio): 139 parts.
- [Cameras](https://partlark.xyz/?category=cameras): 96 parts.
- [Tools & test equipment](https://partlark.xyz/?category=tools): 55 parts.
- [GPS & positioning](https://partlark.xyz/?category=positioning): 47 parts.

## Searching the catalogue

Search with a plain GET request to `https://partlark.xyz/` (the same URL the search form submits; no JavaScript needed). Every parameter is optional and they can be combined:

- `q`: search words; every word must match the part name, alias, part number or a variant label.
- `category`: a category slug, as used in the catalogue's category links (includes sub-categories).
- `platform`: marketplace, `1688` or `taobao`. Repeat it (`platform=1688&platform=taobao`) or comma-separate it to allow several. Only listings on these marketplaces count.
- `min_price` / `max_price`: inclusive bounds on the goods price in CNY (0 to 1000000). Set one for "at least" or "at most", both for "between". They apply to the price shown on each result: the per-item price, or the lowest variant price ("variant price from") when the pack size is unknown.
- `in_stock=1`: only listings currently marked as available.
- `pack`: `single` keeps only variants sold as one item or with an unknown pack size; `multi` keeps only multi-packs with a known size above 1 (e.g. packs of 100). Prices stay per item.
- `sort`: `name` (Name: A to Z), `price` (Goods price: low to high), `price_desc` (Goods price: high to low), `sources` (Most listings), `recently_checked` (Recently checked). Default `name`.
- `per_page`: parts per page, one of 24, 48, 96. Default `24`.
- `page`: 1-based page number.

Marketplace, stock and pack filters apply per listing or variant: the price and listing count shown on each result are computed from the matching ones only. Prices are goods prices in CNY without freight or fees. Invalid values return HTTP 422.

Examples:

- `https://partlark.xyz/?q=ESP32-C3&platform=1688&max_price=15&sort=price`: ESP32-C3 parts on 1688 at ¥15 or less per item, cheapest first.
- `https://partlark.xyz/?q=BME280&min_price=5&max_price=20&in_stock=1`: BME280 parts between ¥5 and ¥20 with an available listing.
- `https://partlark.xyz/?platform=taobao&sort=price_desc&page=2`: second page of parts on Taobao, highest price first.

Each result links to its product page at `/p/<slug>`. Every product also has a compact Markdown version at `/p/<slug>.md` with its specs, listings, prices and ready-made variant links; prefer it over parsing the HTML page. Result pages also embed schema.org `ItemList` JSON-LD with each part's URL, lowest per-item price (`AggregateOffer.lowPrice`, CNY) and listing count (`offerCount`).

## Building a parts list (BOM, project or haul)

When a user asks you to build a bill of materials, project parts list or haul, pick the parts with the search above, then give each chosen item as a full PartLark link, for example:

`https://partlark.xyz/p/c-esp8266-development-boards-eebefb25e3/variant?listing=6529&sku=5819711322228`

Use the variant link (`/p/<slug>/variant?listing=<listing id>&sku=<sku key>`) copied from the product page. If no variant is chosen, use the product link `/p/<slug>`. Never shorten links or make up listing ids or sku values.

Put all the links in one copyable code block, one link per line and nothing else inside the block. Outside the block, list each part's name, quantity and goods price (CNY) so the user can check it, then tell the user to paste the block into the bulk add page to put every part in their haul at once: https://partlark.xyz/basket/bulk-add

## Notes

Listing matches are checked automatically, not a guarantee of compatibility. Superbuy links are affiliate links.