Connect your app to product search.

1. Create a free account, then make an API key in your dashboard.
2. Keep the key on your server. Do not put it in browser code or source control.
3. Send a search with the shopper's market. This example uses GB as its market code.

curl "https://simlir.com/api/v1/search?q=protein+powder&gl=gb&limit=5" \
  -H "Authorization: Bearer sk_your_key"

A search can return fewer products than the requested limit, including no results. The limit is a maximum, not a promise that matching products exist.

Add the hosted endpoint to an MCP client that supports Streamable HTTP. Use a customer API key where supported; ChatGPT uses the Simlir account sign-in and OAuth approval flow. Both use the same account credit and rate limits as REST.

{
  "mcpServers": {
    "simlir": {
      "url": "https://simlir.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Text search and identifier lookup cost 1 credit. Image search costs 2 credits.

Both clients call the same REST API. You still need a Simlir account, an API key and credits for requests.

npm install simlir-js

import { Simlir } from 'simlir-js';

const simlir = new Simlir({ apiKey: process.env.SIMLIR_API_KEY });
const result = await simlir.search({
  query: 'wireless headphones',
  market: 'GB',
  limit: 5,
});

process.stdout.write(JSON.stringify(result.results, null, 2));

python -m pip install simlir

from simlir import Simlir

client = Simlir(api_key="YOUR_API_KEY")
result = client.search(
    query="wireless headphones",
    market="GB",
    limit=5,
)

print(result.results)

Keep SIMLIR_API_KEY in your server environment. Never commit it or send it to a browser.

Send your API key in the Authorization: Bearer header. Discovery search endpoints require one of the supported market codes listed above. Coverage can vary by market, filters and catalogue availability; requests stay within the market you select.

curl -X POST "https://simlir.com/api/v1/search/image" \
  -H "Authorization: Bearer sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/product.jpg",
    "market": "gb",
    "query": "a slim fridge freezer for a small kitchen",
    "limit": 5
  }'

curl "https://simlir.com/api/v1/lookup?identifier=8806095048789&type=gtin&gl=gb" \
  -H "Authorization: Bearer sk_your_key"

Full parameter definitions are in the OpenAPI contract.

These are request limits; each operation also uses credits. Rate-limit responses include Retry-After. See pricing for current credit costs and account options.

Each product can include its title, identifiers, specifications, image, review details, price snapshot and retailer links. Fields vary by product; missing data is not inferred.

• Compare

  Brand, category, identifiers and available specifications.

• Check price

  Amount, currency, retailer and snapshot date when available.

• Explain fit

  A relevance score and product evidence to help your agent explain its choice.

• Open the product

  A product page is preferred; cart and checkout links are used only when no usable product page is available, and a merchant homepage is not used as a product link.

Price and stock can change. A recorded price is a snapshot, not a live checkout quote or a guarantee that a retailer still has the item.

400

Check required fields, market code and value formats.

401

Check that the API key is present and active.

402

Add credits or change your account plan.

403

The account is restricted; contact support if you think this is an error.

404

Check the product ID or endpoint path.

413

Reduce the image or request payload size.

429

Wait for the Retry-After period before trying again.

500 / 502 / 503

Retry later. If it continues, contact support with the request ID.

For API integration support or a security report, email technology@simlir.com. If you have a request ID, include it. Do not email API keys, passwords, or customer data.