{"uid":"cap_HmMUz2LTe7lvWhNwHjUn7","slug":"netintel-semantic-rank-a5fc259a","name":"NetIntel Semantic Rank","description":"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.","url":"https://netintel.dev/semantic/rank","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["query","candidates"],"properties":{"model":{"type":"string","description":"text-embedding-3-small (default) or text-embedding-3-large"},"query":{"type":"string","description":"The text to rank candidates against."},"top_k":{"type":"number","description":"Return only the best N results. Optional."},"min_score":{"type":"number","description":"Drop results scoring below this (-1 to 1). Optional."},"candidates":{"type":"array","items":{"type":"string"},"description":"1-100 candidate strings to rank (64000 chars total on the default model)."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"model":{"type":"string"},"usage":{"type":"object","description":"prompt_tokens (input-only)"},"method":{"type":"string","description":"Always 'embedding_similarity'"},"results":{"type":"array","description":"Ranked best-first: [{index (original position), score, text}]"},"provider":{"type":"string"},"dimensions":{"type":"number"},"normalized":{"type":"boolean"}}}}}}},"responseSchema":{"type":"json","example":{"model":"text-embedding-3-small","usage":{"prompt_tokens":36},"method":"embedding_similarity","results":[{"text":"Use the Forgot Password link to recover your account.","index":0,"score":0.5361},{"text":"Refunds are accepted within 30 days.","index":1,"score":0.1399}],"provider":"openai","dimensions":1536,"normalized":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aCf_fru_iKqQKsshiFfW7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks a list of text passages by semantic similarity to a query using embedding-based scoring","exampleAgentPrompt":"Rank these three support snippets by how relevant they are to the question 'how do I reset my password?': 'Use the Forgot Password link to recover your account.', 'Refunds are accepted within 30 days.', 'Contact billing for invoice issues.' — give me a similarity score for each.","exampleUseCases":null,"resultDescription":"Returns a JSON object with each input passage ranked by cosine similarity score (0–1) to the query, along with the embedding model used (text-embedding-3-small), number of prompt tokens consumed, embedding dimensions (1536), and whether scores are normalized.","failureModes":["Empty or missing passage list returns input validation error with no charge","Query text exceeds token limit causes rejection without billing","Upstream OpenAI embedding API failure returns server error with no charge","Malformed JSON body returns 400 validation error without billing","Too many passages in a single call may exceed limits"],"whenToPreferThis":"Use this endpoint when you need to rerank or score a pre-fetched list of text passages against a query using embedding similarity — ideal for RAG pipelines, FAQ matching, customer support routing, or search result reranking. Pay-per-call at $0.02 USDC with no signup; failed/invalid calls are not billed, making it low-risk for agentic workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:34:33.106Z","isFirstParty":false}