{"uid":"cap_KvTa4ShNYTlUBSD8TC0AM","slug":"agoranome-bazaar-rank-check-4caba67c","name":"Agoranome Bazaar Rank Check","description":"Where does my x402 API rank in Bazaar search? Rank check runs the search a buyer agent would run for your task and returns your rank, the competitor listings ahead of you, and the signals where you trail them (payers, calls, description, output example, schema, price). Search rank, SEO and competitor analysis for x402 listings. A three-result sample is free at /v1/seller/rank/sample.","url":"https://api.agoranome.com/v1/seller/rank?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["task","resource"],"properties":{"task":{"type":"string","description":"What a buyer agent is searching for"},"network":{"type":"string","description":"Optional CAIP-2 network filter"},"resource":{"type":"string","description":"Your listed resource URL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"result":{"gaps":[{"yours":"...","signal":"<signal>","ahead_median":"..."}],"your_rank":"<1-20 or null>","ahead_of_you":["..."]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DGMq8iwWaPTe6iUQd2Y0c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the competitive rank of a seller's listed x402 API resource in Agoranome's Bazaar marketplace for a given buyer agent search query","exampleAgentPrompt":"Check my Bazaar rank for my weather data API at https://api.myservice.com/v1/weather when buyers search for 'real-time weather forecast' — I want to know where I stand and which APIs are beating me.","exampleUseCases":[{"title":"New listing competitive position check","prompt":"I just listed my translation API at https://api.myapp.com/v1/translate on the x402 Bazaar — can you check what rank it gets when buyer agents search for 'language translation' and tell me who's ranked above me?"},{"title":"Pricing strategy informed by rank","prompt":"My API at https://api.mydata.com/v1/stocks is supposed to help buyers looking for 'real-time stock prices' — what's my current Bazaar rank for that search and are there any demand gaps I should know about to move up?"},{"title":"Monitoring rank after listing update","prompt":"I just updated my listing description for https://api.newsapi.xyz/v1/headlines — can you run a rank check on Agoranome for the search task 'breaking news headlines' and see if my position improved versus the competition?"}],"resultDescription":"A JSON object containing your resource's numerical rank (1-20 or null if unranked), an array of competing resource URLs ranked ahead of you, and a gaps array showing signals and comparisons between your listing and higher-ranked rivals — helping you understand why you're losing placements and what to fix.","failureModes":["Resource URL not found in Bazaar listings — returns null rank","Invalid or unsupported CAIP-2 network filter — may return error or ignore filter","Vague or overly broad task query yields unstable rank signal","Payment failure (insufficient USDC balance) — 402 response without rank data","Rate limiting if called too frequently without payment settlement"],"whenToPreferThis":"Use this endpoint when you are a seller of x402 APIs wanting to understand your competitive standing in the Agoranome Bazaar for specific buyer search queries. This is the right choice when you need to know your exact rank position, identify which competing listings are outperforming yours, and discover actionable demand gaps — rather than general API analytics or traffic monitoring tools that don't simulate real buyer agent selection behavior.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T22:15:26.195Z","isFirstParty":false,"canonicalSlug":"agoranome-bazaar-rank-check-4caba67c"}