The SnapEDA Search API returns electronic component listings from SnapMagic Search (ex-SnapEDA). Pass a keyword or a full search URL and receive structured JSON with MPN, manufacturer, distributor pricing, CAD availability, and pagination.
Search results load via client-side AJAX (/api/v1/search_basic). Piloterr uses browser rendering and waits for .search-result-row before parsing.
Supported domains: www.snapeda.com, www.snapmagic.com.
Use each result url or part_number/manufacturer with SnapEDA Product for full part details (datasheet, CAD formats, distributor pricing).
GET https://api.piloterr.com/v2/snapeda/search?query=USB+Type+C
GET https://api.piloterr.com/v2/snapeda/search?query=https://www.snapeda.com/search/?q=Bluetooth+Module
GET https://api.piloterr.com/v2/snapeda/search?query=USB+Type+C&page=2
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Keyword or full search URL |
page |
integer |
no |
1-based page override (default: from URL or 1) |
return_page_source |
boolean |
no |
Rendered HTML as {"result": "..."} (default: false) |
| Field |
Type |
Description |
part_number |
string |
MPN |
manufacturer |
string |
Manufacturer name as displayed |
part_id |
string |
SnapEDA internal id (unipart_id) |
url |
string |
Part page URL (tracking params stripped) |
image_url |
string | null |
Manufacturer logo in search (not part photo) |
description |
string | null |
Short description when available |
package |
string | null |
Package type (often Custom) |
availability |
string | null |
e.g. In Stock, Not in stock |
price |
number | null |
Average distributor price |
currency |
string | null |
ISO currency (typically USD) |
has_symbol |
boolean | null |
Symbol CAD available |
has_footprint |
boolean | null |
Footprint CAD available |
| Field |
Type |
Description |
page |
integer |
Current page |
per_page |
integer |
Results on this page (20) |
total_results |
integer | null |
Total matches |
total_pages |
integer | null |
Total pages |
Pagination uses ?q=…&page=2 in the search URL.
- SnapEDA Search: discover parts (this endpoint)
- SnapEDA Product: full part JSON
| Code |
Meaning |
400 |
Missing or invalid query |
404 |
No parseable search results |
500 |
Rendering or parsing error |
- Search
image_url is the manufacturer logo, not the part photo (use Product for #part-image1).
- Tracking params (
ref, t, ab_test_case, p) are stripped from returned URLs.
- Costs 2 credits per call (browser rendering, up to 90s wait).
- Component discovery: harvest MPNs and manufacturers at scale
- CAD availability: filter parts with symbol/footprint models
- BOM enrichment: pricing and stock signals before fetching full PDP data
