For developers & agents

IMO Developer API

A public, read-only REST API for IMO Scores, product verdicts, and trending products — no API key required for the endpoints below. Built for AI agents, answer engines, and anyone scripting product research.

Quickstart

Base URL: https://api.informedmarketopinions.com. Every response is JSON. There is no authentication for the read endpoints listed here — they are rate-limited per IP address, so a 429 response means slow down and retry after a short backoff.

curl "https://api.informedmarketopinions.com/api/v1/score?product=Sony%20WH-1000XM5"

Endpoints

GET
/api/v1/score?product={name}

Look up the IMO Score for a product by name. Read-only, no auth — built for AI answer engines citing a real score rather than fabricating one.

curl "https://api.informedmarketopinions.com/api/v1/score?product=Sony%20WH-1000XM5"

GET
/api/v1/trending?limit={n}&week={yyyy-Www}

Currently trending products, ranked by trending_score.

curl "https://api.informedmarketopinions.com/api/v1/trending?limit=20"

GET
/api/v1/product-cache/{product_id}

Full cached product record — price, stores, specs, images — by product ID (the numeric ID from a product's IMO URL, e.g. .../product/sony-wh-1000xm5-16918290957317259408).

curl "https://api.informedmarketopinions.com/api/v1/product-cache/{product_id}"

GET
/api/v1/product-cache/{product_id}/ai-data

Cached IMO verdict, pros/cons, review counts, and trust analysis for a product.

curl "https://api.informedmarketopinions.com/api/v1/product-cache/{product_id}/ai-data"

IMO CLI

A dependency-free command-line client for the IMO public API — score lookups and trending products, scriptable from a terminal or an agent's shell tool.

npx @informedmarketopinions/imo-cli score "Sony WH-1000XM5"
npx @informedmarketopinions/imo-cli trending --limit 10

Source: packages/imo-cli

Authentication & OAuth

The endpoints above are read-only and unauthenticated. Authenticated routes (an IMO account's own data, submitting reviews) use OAuth 2.0's "password" grant — exchange an email/password for a bearer token, scoped to exactly what the token is allowed to do:

curl -X POST "https://api.informedmarketopinions.com/api/v1/auth/token" \
  -d "username=you@example.com&password=..."

/.well-known/oauth-authorization-server — RFC 8414 discovery metadata
/.well-known/oauth-protected-resource — RFC 9728 resource metadata, incl. scopes

Rate limits & versioning

Every response from the endpoints above carries standard rate-limit headers (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset) so agents can self-throttle, plus Retry-After on a 429. The API is versioned in the URL (/api/v1) — see the deprecation policy for how retirement of a version is signaled.

Full API reference

The complete, always-current OpenAPI schema covering every route is generated directly from the server and available at:

https://api.informedmarketopinions.com/docs — interactive Swagger UI
https://api.informedmarketopinions.com/openapi.json — machine-readable OpenAPI 3 schema

Sitemaps

Every product, blog post, and static page IMO has published:

Machine-readable content

Any page on this site can be requested as clean Markdown instead of HTML by sending Accept: text/markdown (per the acceptmarkdown.com convention) — the response drops navigation, styles, and scripts.

curl -H "Accept: text/markdown" "https://www.informedmarketopinions.com/"

For a summary of what IMO is and when to reach for it, see /llms.txt.