REST API

Search Bobby's product catalog with a simple HTTP request

Base URL

https://api.searchbobby.com

Authentication

All requests require an API key passed via the X-Agent-Key header.

curl -H "X-Agent-Key: YOUR_API_KEY" \
  "https://api.searchbobby.com/search/products?query=nike+hoodie"

Your API Key

1 active key per account. Revoke to generate a new one.

GET

/search/products

Search across millions of products with optional filters. Add rerank=true for higher quality results.

Query Parameters

querystringrequired

Search query

limitinteger

Results to return (1–50, default 10)

rerankboolean

Enable cross-encoder reranking for higher quality results

brandstring

Filter by brand name

min_pricenumber

Minimum price

max_pricenumber

Maximum price

currencystring

Currency code (e.g. GBP, USD, EUR)

countrystring

ISO country code (e.g. GB, US, DE)

availabilitystring

e.g. in_stock, out_of_stock, preorder

conditionstring

e.g. new, refurbished, used

source_domainstring

Filter by merchant domain

Example Request

curl -H "X-Agent-Key: YOUR_API_KEY" \
  "https://api.searchbobby.com/search/products?query=wireless+headphones&limit=5&rerank=true&currency=GBP&max_price=100"

Response

{
  "query": "wireless headphones",
  "results": [
    {
      "id": "a1b2c3d4-...",
      "score": 0.82,
      "title": "Sony WH-1000XM5 Wireless Headphones",
      "description": "Industry-leading noise cancelling...",
      "product_url": "https://api.searchbobby.com/api/click/r/a1b2c3d4-...",
      "image_url": "https://...",
      "price": 89.99,
      "sale_price": null,
      "currency": "GBP",
      "brand": "Sony",
      "availability": "in_stock",
      "condition": "new",
      "country": "GB",
      "source_domain": "example.com",
      "bobby_vertical": "Electronics & Tech",
      "rerank_score": 0.91
    }
  ],
  "elapsed_seconds": 0.34
}

GET

/search/products/precision

Same parameters as /search/products but always reranked. Returns both vector_score and rerank_score. Max 20 results.

Rate Limits

60 / min

Search endpoints

Free

No cost to use

Rate limits are applied per API key. Exceeding the limit returns 429 Too Many Requests.

Notes

Product URLs use click tracking — always use the product_url from the response, not the raw merchant URL.
Affiliate tracking is included in all product links automatically.
Results with rerank_score below 0.01 are filtered out when reranking is enabled.
The id field is a stable UUID — use it for deduplication or linking to /item/{id} on searchbobby.com.

Free for personal use. Rate limited to 60 requests per minute.
Affiliate tracking is included in all product links automatically.