Skip to content
LINQSLINQS

LINQS developer portal

LINQS Developer Resources

LINQS publishes a small public, read-only HTTP API for NFC product discovery. It is useful when a website, script, or AI agent needs to search products, read store configuration, or retrieve the structured catalog without scraping product pages.

Quick start

No API key or account is required. All documented operations are read-only.

curl -H "X-LINQS-API-Version: 2026-08-24"   "https://shop.linqs.in/api/search?q=ntag213"
curl "https://shop.linqs.in/llms-json"

API stability and request limits

The current date-based contract version is 2026-08-24. Send it in the X-LINQS-API-Version request header when you need a pinned contract; clients that omit the header receive the current version.

A breaking contract change receives a new date. A retired version will be announced for at least 90 days using standard Deprecation, Sunset, and migration Link response headers.

Public endpoints currently allow 120 requests per client per running instance in each 60-second window. Responses include version and rate-limit headers. Exceeded limits return JSON with HTTP 429 and aRetry-After header; unsupported methods return structured JSON with HTTP 405.

API and catalog resources

OpenAPI 3.1 contract

Typed operations, parameters, success responses, and structured error models.

API catalog

Machine-readable discovery links for the public API and catalog resources.

Structured product catalog

Public product data for filtering, shortlisting, and recommendation workflows.

Catalog schema

Field definitions and the stable response contract for catalog consumers.

Request and response examples

Practical examples for search, filtering, and structured catalog use.

Agent onboarding

Source hierarchy, routing rules, and NFC recommendation guardrails.

Supported boundaries

  • The API is public and read-only; it does not create carts, checkouts, or orders.
  • Live price and stock claims should be confirmed on the linked product page.
  • Unknown API paths return a structured JSON error with recovery guidance.
  • LINQS does not currently operate a public MCP server, SDK, CLI, or webhook API.
  • The storefront is trialing experimental in-browser WebMCP tools (document.modelContext, with compatibility for the earlier Chrome trial API) for visitors' own browser agents. They wrap the same read-only operations documented above, run only inside that visitor's browsing session, and expose no cart, checkout, order, or account actions. They are not a remote API and may be unavailable outside the current Chrome origin trial.

Product and integration questions

For product selection, bulk orders, custom printing, or encoding support, use the LINQS contact page.