PedalBro

Search guitar and bass pedals by brand, model, nickname or type (typos are fine), optionally only those buyable new under a price. Returns names, slugs and lowest new prices.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 100,
      "description": "e.g. 'tube screamer', 'strymon delay', 'fuzz'"
    },
    "category": {
      "description": "Category slug to narrow to, e.g. overdrive, fuzz, distortion, delay, reverb, chorus, compressor, looper",
      "type": "string",
      "maxLength": 60
    },
    "brand": {
      "description": "Brand slug, e.g. boss, strymon, electro-harmonix",
      "type": "string",
      "maxLength": 60
    },
    "maxPriceUsd": {
      "description": "Only pedals buyable new and in stock at or under this price",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Everything PedalBro knows about one pedal: specs (power, size, bypass, controls), a plain-language summary, the PedalBro review score, what players say, professional review ratings with links, current new and used prices with buy links, and similar pedals.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A pedal slug from search_pedals, e.g. boss-ds-1-distortion"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Two to five pedals side by side: score, what each is best for, lowest new price, used median and key specs.

{
  "type": "object",
  "properties": {
    "slugs": {
      "minItems": 2,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "A pedal slug from search_pedals, e.g. boss-ds-1-distortion"
      }
    }
  },
  "required": [
    "slugs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

How a pedal's new and used prices have moved over the last 90 days (weekly points), recent sold used listings, and current prices. Useful for 'is this a good price' and 'should I buy used'.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A pedal slug from search_pedals, e.g. boss-ds-1-distortion"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check a set of pedals as a pedalboard: a suggested signal-chain order with reasons, total current draw against a power supply, and a count of power and compatibility issues.

{
  "type": "object",
  "properties": {
    "pedals": {
      "minItems": 1,
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120,
        "description": "A pedal slug from search_pedals, e.g. boss-ds-1-distortion"
      },
      "description": "Pedal slugs from search_pedals, in any order"
    },
    "supplyTotalMa": {
      "description": "The power supply's total current in mA, if known",
      "type": "integer",
      "minimum": 1,
      "maximum": 20000
    },
    "supplyOutlets": {
      "description": "How many outputs the power supply has",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "usesFxLoop": {
      "default": false,
      "description": "True if the amp's effects loop is used, so time-based effects can go in the loop",
      "type": "boolean"
    }
  },
  "required": [
    "pedals"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

PedalBro's buying guides ('best overdrive pedals', 'best delay under $200', ...), each with its top pick. Use get_guide for the full picks.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One buying guide: who it is for, what matters when choosing, the three picks (best overall, budget, step up) with strengths, flaws and current prices, and the other pedals considered.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "description": "A guide slug from list_guides"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}