Semantic similarity ranking — send a query plus up to 100 candidate texts, get the cand…

What it does

Semantic similarity ranking — send a query plus up to 100 candidate texts, get the candidates back ranked by semantic similarity with scores. No vectors, no cosine math, no embedding model to manage: one call, one price, ranked results. Flat $0.02 per call in USDC via x402, no API key. For RAG retrieval, FAQ matching, and search result ordering.

Tags: semantic search · rank · similarity · rag · no api key · bazaar

Call contract

Method

POST

Input

json

Output

json

Last paid call

2026-10-08

{
  "candidates": [
    "Use the Forgot Password link to recover your account.",
    "Refunds are accepted within 30 days.",
    "Our offices open at 9:00 AM."
  ],
  "query": "How do I reset my password?",
  "top_k": 2
}

{
  "dimensions": 1536,
  "method": "embedding_similarity",
  "model": "text-embedding-3-small",
  "normalized": true,
  "provider": "openai",
  "results": [
    {
      "index": 0,
      "score": 0.5361,
      "text": "Use the Forgot Password link to recover your account."
    },
    {
      "index": 1,
      "score": 0.1399,
      "text": "Refunds are accepted within 30 days."
    }
  ],
  "usage": {
    "prompt_tokens": 36
  }
}

Use with an agent

1. Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
2. Inspect. Fetch /resources/29577.json for the price and payment options.
3. Pay. Call GET https://netintel.dev/semantic/rank. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
4. Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Solana, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price

$0.02 / request

Protocol

x402 v2

Auth

No account or API key. Pay per request.

Networks

Base, Solana

Demand

2 calls · 2 unique payers in 30d (public x402 Bazaar data)

x402 payment requirements

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xdaDc335482AD545296Fd7b28518A251fFCbEb9Df",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "amountUsd": 0.02,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "8FVeybWnB4dYrxTuPK7WzFZNAiEcFVaDLFnKpRwVGr5s",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "20000",
    "amountUsd": 0.02,
    "maxTimeoutSeconds": 300
  }
]

Schemas

{
  "properties": {
    "example": {
      "properties": {
        "dimensions": {
          "type": "number"
        },
        "method": {
          "description": "Always 'embedding_similarity'",
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "normalized": {
          "type": "boolean"
        },
        "provider": {
          "type": "string"
        },
        "results": {
          "description": "Ranked best-first: [{index (original position), score, text}]",
          "type": "array"
        },
        "usage": {
          "description": "prompt_tokens (input-only)",
          "type": "object"
        }
      },
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

{
  "example": {
    "dimensions": 0,
    "method": "string",
    "model": "string",
    "normalized": true,
    "provider": "string",
    "results": [
      "value"
    ],
    "usage": {}
  },
  "type": "string"
}

Examples

curl -X POST 'https://netintel.dev/semantic/rank' -H 'Content-Type: application/json' --data '{"candidates":["Use the Forgot Password link to recover your account.","Refunds are accepted within 30 days.","Our offices open at 9:00 AM."],"query":"How do I reset my password?","top_k":2}'
# -> 402 Payment Required; read PAYMENT-REQUIRED
# retry the identical request with PAYMENT-SIGNATURE

const res = await fetch("https://netintel.dev/semantic/rank", {
  "method": "POST",
  "headers": {
    "content-type": "application/json"
  },
  "body": "{\"candidates\":[\"Use the Forgot Password link to recover your account.\",\"Refunds are accepted within 30 days.\",\"Our offices open at 9:00 AM.\"],\"query\":\"How do I reset my password?\",\"top_k\":2}"
});
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
import json
res = httpx.request("POST", "https://netintel.dev/semantic/rank", json=json.loads("{\"candidates\":[\"Use the Forgot Password link to recover your account.\",\"Refunds are accepted within 30 days.\",\"Our offices open at 9:00 AM.\"],\"query\":\"How do I reset my password?\",\"top_k\":2}"))
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider

netintel.dev

Endpoint

https://netintel.dev/semantic/rank

Machine-readable

/resources/29577.json