{"uid":"cap_P5MKzbVxnDUdm4e1nIXX-","slug":"wikidata-entity-search-q-id-lookup-b295cecf","name":"Wikidata Entity Search (Q-ID Lookup)","description":"Wikidata entity search (find the Q-id for any person, company, place, thing) — Genesis402 / UnyKorn Operator Network","url":"https://twin.unykorn.org/research/wikidata-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"params":{"type":"object","properties":{"q":{"type":"string","description":"required"},"limit":{"type":"integer","maximum":20,"minimum":1,"description":"optional: max rows (default 5, max 20)"}}}}},"responseSchema":{"type":"json","example":{"ok":true,"type":"wikidata-search","receipt":{"tx_hash":"0x<64hex>","amount_usd":0.002,"receipt_id":"g402-<16hex>"},"sources":[{"ok":true,"name":"<source>"}],"limitations":"<text>","generated_at":"<iso time>","evidence_hash":"sha256:<64hex>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7VmWAY7ZZfndzA48tBFqx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Wikidata to find the canonical Q-identifier (e.g. Q76, Q2) for any named person, company, place, concept, or thing","exampleAgentPrompt":"What's the Wikidata Q-ID for Elon Musk? Give me up to 3 results so I can pick the right one.","exampleUseCases":[{"title":"Entity disambiguation for knowledge graph","prompt":"I'm building a knowledge graph and need the Wikidata Q-ID for 'Apple' — can you search Wikidata and return the top 5 results so I can tell whether it's the company or the fruit?"},{"title":"Linking historical figure to structured data","prompt":"Can you find the Wikidata Q-ID for Marie Curie so I can link her to external structured datasets?"},{"title":"Resolving a place name to canonical ID","prompt":"What's the Wikidata Q-ID for the city of Nairobi? Just give me the top result."}],"resultDescription":"Returns a ranked list of matching Wikidata entities, each with a Q-ID (e.g. Q76), a human-readable label, a short description disambiguating the entity, and a link to its Wikidata page. Up to 20 results can be returned per query (default 5).","failureModes":["No matching entities found for an obscure or misspelled query — returns empty result list","Ambiguous query returns many unrelated entities requiring manual disambiguation","Rate limiting or upstream Wikidata API unavailability — may return 5xx error","Invalid limit parameter (outside 1–20 range) returns a validation error","Non-string or missing 'q' parameter causes a 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need to resolve a named entity (person, organization, location, concept) to its canonical Wikidata Q-identifier, particularly for knowledge graph enrichment, linked data pipelines, or entity disambiguation. Prefer this over a general web search when you specifically need a structured, machine-readable Wikidata ID rather than web page links or prose descriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-03T00:45:39.796Z","isFirstParty":false,"canonicalSlug":"wikidata-entity-search-q-id-lookup-b295cecf"}