{"uid":"cap_YxkQPnpMcS0P9nPDB7q2f","slug":"wikidata-entity-search-d02583b3","name":"Wikidata Entity Search","description":"Search Wikidata by name; returns candidate Q-ids with descriptions and instance-of hints to disambiguate.","url":"https://wikidata-facts.x402tookit.com/entity-search?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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Name to search, e.g. Mercury or Paris"},"hint":{"type":"string","description":"Optional words; candidates whose text contains them are listed first"},"limit":{"type":"integer","description":"Candidates 1 to 10 (default 5)"},"language":{"type":"string","description":"Language code for labels (default en), e.g. fr"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"query":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"results":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","string"]},"url":{"type":["null","string"]},"label":{"type":["null","string"]},"matchedOn":{"type":["null","object"],"properties":{"text":{"type":["null","string"]},"type":{"type":["null","string"]}}},"instanceOf":{"type":["array","null"],"items":{"type":"string"}},"description":{"type":["null","string"]}}}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"language":{"type":["null","string"]},"ambiguous":{"type":["boolean","null"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qqhbYt1o1J3toZniNNcQW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Wikidata by name and return candidate Q-ids with labels, descriptions, and instance-of hints for disambiguation.","exampleAgentPrompt":"Search Wikidata for 'Mercury' and give me up to 5 candidate entities with their Q-ids and descriptions — use 'planet' as a hint to prioritize the astronomical body.","exampleUseCases":[{"title":"Disambiguating a famous name before fact-fetching","prompt":"I need the Wikidata Q-id for 'Victoria' — can you search Wikidata and show me the top candidates with descriptions so I can tell which one is Queen Victoria the monarch?"},{"title":"Resolving a city name for data enrichment","prompt":"Search Wikidata for 'Springfield' and give me up to 10 candidates with their instance-of types so I can figure out which one is the city in Illinois."},{"title":"Finding a company entity before linking external data","prompt":"Look up 'Tesla' on Wikidata and return the matching Q-ids with descriptions — use 'company' as a hint so the automaker comes first rather than the inventor."}],"resultDescription":"Returns a ranked list of up to 10 candidate Wikidata entities matching the search query, each with a Q-id, Wikidata URL, display label, short description, the text and type that triggered the match, and a list of instance-of type labels. Also includes query metadata, source attribution, a summary, an ambiguity flag, and the language used.","failureModes":["No candidates found for very obscure or misspelled names — returns empty results array","Rate limiting or payment failure (x402) if USDC payment is not completed","Ambiguity not resolved if hint is too vague — multiple high-scoring candidates returned","Language code not supported — falls back to English or returns error","Limit parameter outside 1–10 range may be rejected or clamped"],"whenToPreferThis":"Use this endpoint as the first step when you have an entity name and need its Wikidata Q-id before fetching detailed facts, properties, or linked identifiers. It is ideal when the name is ambiguous (e.g. 'Paris', 'Mercury', 'Victoria') and you need instance-of and description hints to pick the right entity. Prefer this over direct property lookups when you don't already know the Q-id.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:19:48.331Z","isFirstParty":false,"canonicalSlug":"wikidata-entity-search-d02583b3"}