Wikidata Entity API

Wikidata Entity API helps you search Wikidata and export structured entity records with labels, descriptions, aliases, sitelinks, and search-match context. Use it for research, enrichment, knowledge graph lookups, and content workflows.

Why use this actor?

This actor turns Wikidata into a clean dataset you can use in AI workflows, research pipelines, and knowledge enrichment tasks. It is especially useful when you need canonical entity IDs, readable descriptions, and quick context about a person, company, product, or topic.

Features

• Search Wikidata by keyword and language
• Hydrate one or more Wikidata entity IDs
• Include alias summaries for richer entity context
• Optionally include sitelink counts and the English Wikipedia URL
• No API key required
• Pay-per-event pricing aligned to successful entity records only

Input

Search for entities

{
  "mode": "search",
  "query": "OpenAI",
  "maxResults": 20,
  "language": "en"
}

Hydrate entity IDs

{
  "mode": "entity",
  "entityIds": "Q95,Q76,Q42",
  "includeAliases": true,
  "includeSitelinks": true
}

Input fields

• mode (string): search, entity, or both.
• query (string): search query used when mode includes search.
• entityIds (string): comma-separated Wikidata IDs such as Q42,Q76.
• language (string): language code used for search.
• maxResults (integer): maximum records to return, capped at 50.
• includeAliases (boolean): include a compact alias sample when hydrating entities.
• includeSitelinks (boolean): include sitelink counts and English Wikipedia URL when available.

Output

Sample record:

{
  "recordType": "search-result",
  "query": "OpenAI",
  "entityId": "Q21708200",
  "title": "OpenAI",
  "label": "OpenAI",
  "description": "American artificial intelligence research organization",
  "conceptUri": "http://www.wikidata.org/entity/Q21708200",
  "wikidataUrl": "https://www.wikidata.org/wiki/Q21708200",
  "pageId": 23747017,
  "repository": "wikidata",
  "matchType": "label",
  "matchLanguage": "en",
  "matchText": "OpenAI",
  "entityType": "",
  "aliasesCount": 0,
  "aliasSample": "",
  "sitelinksCount": 0,
  "englishWikipediaUrl": "",
  "claimsCount": 0,
  "language": "en"
}

Use cases

• Build knowledge graphs and enrichment workflows
• Normalize company, person, and topic references
• Pull canonical identifiers for AI and search pipelines
• Map aliases and related names into downstream systems
• Improve entity resolution in content and research tools

Limits and caveats

• Search results are relevance-based, so very broad queries may require tighter wording.
• Entity hydration is most useful when you provide Wikidata IDs.
• Some records may have sparse English labels or descriptions.

Pricing

This actor uses pay-per-event pricing:

Event	Price	When it's charged
entity-record-produced	$0.0008 / item	Per search result or entity record successfully produced

You pay only for records returned by the actor.

FAQ

Do I need an API key?

No. Wikidata is public.

Can I search in another language?

Yes. Set language to the desired language code.

What if my run charge limit is reached?

The actor stops gracefully after the last chargeable record and keeps already produced items.