---
title: "Search SparkFun products"
method: GET
path: "/sparkfun/search"
tags: ["SparkFun"]
---

# Search SparkFun products

`GET /sparkfun/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sparkfun/search`
- Auth: API key in header `x-api-key`

Searches public SparkFun product data with pagination and dynamic facet filters. Each filter must be `attribute:value`; use values from the response's filters array.

## Query parameters

- `q` string, required
- `page` integer
- `per_page` integer
- `filter` string[]

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SparkfunSearchResponseDoc
  - `code` integer
  - `data` SparkfunSearchResponse
    - `filters` SparkfunFilter[]
      - `attribute` string
      - `label` string
      - `options` SparkfunFilterOption[]
        - `count` integer
        - `label` string
        - `value` string
    - `page` integer
    - `per_page` integer
    - `products` SparkfunProduct[]
      - `categories` SparkfunCategory[]
        - `id` string
        - `name` string
        - `url_key` string
        - `url_path` string
      - `description` string
      - `image` SparkfunImage
        - `label` string
        - `url` string
      - `media` SparkfunImage[]
        - `label` string
        - `url` string
      - `name` string
      - `price` SparkfunPrice
        - `currency` string
        - `value` number
      - `recommendations` SparkfunProductRecommendation[]
        - `product` SparkfunProduct (recursive)
        - `relation` string
      - `sku` string
      - `stock_status` string
      - `url` string
    - `query` string
    - `total` integer
    - `total_pages` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)