DataHub website screenshot

DataHub

DataHub is LinkedIn's generalized metadata search and discovery platform, providing a unified data catalog, lineage graph, governance tooling, and event-driven Actions Framework. It exposes GraphQL, OpenAPI, and Rest.li APIs along with Python and Java SDKs and a CLI for metadata ingestion.

DataHub publishes 6 APIs on the APIs.io network, including Actions Framework, Batch API, Entities API, and 3 more. Tagged areas include Data Catalog, Data Discovery, Data Governance, Data Lineage, and Metadata.

The DataHub catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 3 Spectral governance rulesets.

DataHub’s developer surface includes authentication, developer portal, documentation, getting-started guide, engineering blog, changelog, YouTube channel, and 24 more developer resources.

59.1/100 strong ▼ -5.9 Agent 43/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessEnterpriseSelf serve
11 APIs
Data CatalogData DiscoveryData GovernanceData LineageMetadata

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 59.1/100 · strong
Contract Quality 18.3 / 25
Developer Ergonomics 10.0 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 8.2 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 43/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/datahub: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 11

Individual APIs this provider publishes, each with its own machine-readable definition.

DataHub GraphQL API

Primary API for querying and mutating metadata in DataHub. The GraphQL API serves as the main public API for the platform and can be used to fetch and update metadata programmat...

DataHub REST API

The Rest.li API represents the underlying persistence layer and exposes the raw PDL models used in storage. It powers the GraphQL API under the hood and is used for system-speci...

DataHub Python SDK

Python client for interacting with DataHub. The acryl-datahub package provides a CLI and SDK for DataHub, including REST and Kafka emitter APIs for pushing metadata programmatic...

DataHub Java SDK

Java client for interacting with DataHub. The io.acryl datahub-client package offers REST emitter APIs that can be used to emit metadata from JVM-based systems. It supports all ...

DataHub CLI

Command line tool for interacting with DataHub. The datahub CLI allows you to perform common operations including metadata ingestion, entity management, and system administratio...

DataHub Actions Framework

Event-driven framework for responding to real-time changes in the DataHub metadata graph. The Actions Framework allows you to configure event sources, transformations, and actio...

DataHub Batch API

Batch operations for fetching multiple entities and their aspects in a single request. Supports version-specific retrieval and conditional writes.

DataHub Entities API

Read, write, and delete metadata entities in the DataHub metadata graph. The entities endpoints support upserting entity-aspect pairs, retrieving the latest aspects for a given ...

DataHub Platform API

Write metadata events using the standard platform format. Provides an alternative ingestion path for emitting metadata change proposals to the DataHub metadata graph.

DataHub Relationships API

Query the relationship graph to navigate connections between entities. Supports filtering by relationship type and traversal direction (incoming or outgoing) from a given entity...

DataHub Timeline API

Query the versioned history of entity aspects over time. Useful for tracking schema changes, documentation updates, and other temporal metadata modifications for a given entity.

Scroll for all 11

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

DataHub OpenAPI

OPEN COLLECTION

Arazzo Workflows 7

Multi-step API workflows described with the Arazzo specification.

DataHub Add Glossary Terms to a Dataset

Confirm a dataset, attach glossary terms via its glossaryTerms aspect, then review the change in the entity timeline.

ARAZZO

DataHub Assign Dataset Ownership

Write an ownership aspect onto a dataset, then read it back to verify the owners were recorded.

ARAZZO

DataHub Decommission a Dataset

Confirm a dataset, check it has no downstream dependents, then soft delete it from the metadata graph.

ARAZZO

DataHub Emit Platform Event and Audit

Emit a metadata change proposal through the platform ingestion path, then read the entity back and review its timeline.

ARAZZO

DataHub Tag a Dataset

Confirm a dataset exists, then write its globalTags aspect to apply governance tags.

ARAZZO

DataHub Trace Dataset Lineage

Confirm a dataset, query its downstream relationships, then batch fetch the related datasets' aspects.

ARAZZO

DataHub Upsert Dataset and Verify

Write a dataset's properties aspect into the metadata graph, then read the entity back to confirm the write landed.

ARAZZO

Scroll for all 7

GraphQL 1

GraphQL schemas published by this provider.

DataHub GraphQL API

Primary API for querying and mutating metadata in DataHub. The GraphQL API serves as the main public API for the platform and can be used to fetch and update metadata programmat...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Datahub Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Datahub Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

DataHub Actions Framework Events

Event-driven interface for responding to real-time changes in the DataHub metadata graph. The Actions Framework consumes Metadata Change Log events and Platform Events from Kafk...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Datahub Context

0 classes · 9 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs.

DataHub API Rules

5 rules · 4 warnings 1 info

SPECTRAL

DataHub API Rules

5 rules · 3 warnings 2 info

SPECTRAL

DataHub API Rules

5 rules · 1 errors 4 warnings

SPECTRAL

JSON Schema 14

Standalone JSON Schema definitions for this provider's data models.

AspectValue

3 properties

JSON SCHEMA

AuditStamp

2 properties

JSON SCHEMA

BatchGetRequest

2 properties

JSON SCHEMA

ChangeEvent

4 properties

JSON SCHEMA

ChangeTransaction

4 properties

JSON SCHEMA

EntityAspectRequest

4 properties

JSON SCHEMA

EntityAspectResponse

3 properties

JSON SCHEMA

Error

3 properties

JSON SCHEMA

DataHub Metadata Change Log Event

8 properties

JSON SCHEMA

MetadataChangeProposal

6 properties

JSON SCHEMA

Relationship

3 properties

JSON SCHEMA

RelationshipsResponse

4 properties

JSON SCHEMA

SystemMetadata

4 properties

JSON SCHEMA

TimelineResponse

1 properties

JSON SCHEMA

Scroll for all 14

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Datahub Structure

0 properties

JSON STRUCTURE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Datahub Authentication

http · 1 scheme

SECURITY

Datahub Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Datahub Agentic Access

7 operations · 4 acting

7 operations · 4 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 10

Pagination, idempotency, versioning, errors, and events

Scroll for all 10

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 4

Status, limits, changes, and where to get help

Commercial 1

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: datahub
name: DataHub
description: DataHub is LinkedIn's generalized metadata search and discovery platform, providing a unified data catalog, lineage
  graph, governance tooling, and event-driven Actions Framework. It exposes GraphQL, OpenAPI, and Rest.li APIs along with
  Python and Java SDKs and a CLI for metadata ingestion.
accessModel:
  pricing: enterprise
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Enterprise · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://datahubproject.io/img/datahub-logo.svg
type: Index
tags:
- Data Catalog
- Data Discovery
- Data Governance
- Data Lineage
- Metadata
created: '2024-01-15'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/datahub/refs/heads/main/apis.yml
specificationVersion: '0.19'
kind: opensource
position: Consumer
access: 3rd-Party
apis:
- aid: datahub:datahub-graphql-api
  name: DataHub GraphQL API
  description: Primary API for querying and mutating metadata in DataHub. The GraphQL API serves as the main public API for
    the platform and can be used to fetch and update metadata programmatically in the language of your choice. It mirrors
    the capabilities available in the DataHub UI.
  image: https://datahubproject.io/img/datahub-logo.svg
  humanURL: https://docs.datahub.com/docs/api/graphql/overview
  baseURL: http://localhost:8080/api/graphql
  tags:
  - GraphQL
  - Metadata
  - Queries
  - Search
  properties:
  - type: Documentation
    url: https://docs.datahub.com/docs/api/graphql/overview
  - type: GettingStarted
    url: https://docs.datahub.com/docs/api/graphql/getting-started
  - type: Reference
    url: https://docs.datahub.com/docs/graphql/queries
  - type: Playground
    url: http://localhost:8080/api/graphiql
  - url: graphql/datahub-graphql.md
    type: GraphQL
- aid: datahub:datahub-rest-api
  name: DataHub REST API
  description: The Rest.li API represents the underlying persistence layer and exposes the raw PDL models used in storage.
    It powers the GraphQL API under the hood and is used for system-specific ingestion of metadata by the Metadata Ingestion
    Framework. This API is considered system-internal and is not recommended for direct external use.
  image: https://datahubproject.io/img/datahub-logo.svg
  humanURL: https://docs.datahub.com/docs/api/datahub-apis
  baseURL: http://localhost:8080/
  tags:
  - Entities
  - Internal
  - Metadata
  - REST
  properties:
  - type: Documentation
    url: https://docs.datahub.com/docs/api/datahub-apis
- aid: datahub:datahub-python-sdk
  name: DataHub Python SDK
  description: Python client for interacting with DataHub. The acryl-datahub package provides a CLI and SDK for DataHub, including
    REST and Kafka emitter APIs for pushing metadata programmatically. It is one of the most recommended tools for extending
    and customizing DataHub behavior, especially for ingestion and bulk metadata operations.
  image: https://datahubproject.io/img/datahub-logo.svg
  humanURL: https://docs.datahub.com/docs/metadata-ingestion/as-a-library
  baseURL: https://pypi.org/project/acryl-datahub/
  tags:
  - Emitter
  - Ingestion
  - Python
  - SDK
  properties:
  - type: Documentation
    url: https://docs.datahub.com/docs/metadata-ingestion/as-a-library
  - type: GitHubRepository
    url: https://github.com/datahub-project/datahub
  - type: SDKs
    url: https://pypi.org/project/acryl-datahub/
- aid: datahub:datahub-java-sdk
  name: DataHub Java SDK
  description: Java client for interacting with DataHub. The io.acryl datahub-client package offers REST emitter APIs that
    can be used to emit metadata from JVM-based systems. It supports all major DataHub entity types including Dataset, Chart,
    Dashboard, Container, DataFlow, DataJob, MLModel, and MLModelGroup.
  image: https://datahubproject.io/img/datahub-logo.svg
  humanURL: https://docs.datahub.com/docs/metadata-integration/java/as-a-library
  baseURL: https://github.com/datahub-project/datahub
  tags:
  - Emitter
  - Java
  - Metadata
  - SDK
  properties:
  - type: Documentation
    url: https://docs.datahub.com/docs/metadata-integration/java/as-a-library
  - type: GitHubRepository
    url: https://github.com/datahub-project/datahub
- aid: datahub:datahub-cli
  name: DataHub CLI
  description: Command line tool for interacting with DataHub. The datahub CLI allows you to perform common operations including
    metadata ingestion, entity management, and system administration from the command line. It is installed as part of the
    acryl-datahub Python package and supports a plugin architecture for different data source connectors.
  image: https://datahubproject.io/img/datahub-logo.svg
  humanURL: https://docs.datahub.com/docs/cli
  baseURL: https://pypi.org/project/acryl-datahub/
  tags:
  - CLI
  - Command Line
  - Ingestion
  - Metadata
  properties:
  - type: Documentation
    url: https://docs.datahub.com/docs/cli
  - type: GettingStarted
    url: https://docs.datahub.com/docs/metadata-ingestion/cli-ingestion
  - type: SDKs
    url: https://pypi.org/project/acryl-datahub/
- aid: datahub:datahub-actions-framework
  name: DataHub Actions Framework
  description: Event-driven framework for responding to real-time changes in the DataHub metadata graph. The Actions Framework
    allows you to configure event sources, transformations, and actions using YAML configuration files. It enables seamless
    integration of DataHub into a broader event-based architecture by consuming Metadata Change Logs and Platform Events.
  image: https://datahubproject.io/img/datahub-logo.svg
  humanURL: https://docs.datahub.com/docs/actions
  baseURL: https://pypi.org/project/acryl-datahub-actions/
  tags:
  - Actions
  - Automation
  - Events
  - Real-Time
  properties:
  - type: Documentation
    url: https://docs.datahub.com/docs/actions
  - type: GettingStarted
    url: https://docs.datahub.com/docs/actions/quickstart
  - type: SDKs
    url: https://pypi.org/project/acryl-datahub-actions/
  - type: AsyncAPI
    url: asyncapi/datahub-actions-asyncapi.yml
- aid: datahub:datahub-batch-api
  name: DataHub Batch API
  description: Batch operations for fetching multiple entities and their aspects in a single request. Supports version-specific
    retrieval and conditional writes.
  humanURL: https://docs.datahub.com/docs/api/graphql/overview
  baseURL: http://localhost:8080/api/graphql
  tags:
  - Batch
  properties:
  - type: OpenAPI
    url: openapi/datahub-batch-api-openapi.yml
  - type: Documentation
    url: https://docs.datahub.com/docs/api/openapi/openapi-usage-guide
  - type: JSONSchema
    url: json-schema/datahub-metadata-change-log-event-schema.json
- aid: datahub:datahub-entities-api
  name: DataHub Entities API
  description: Read, write, and delete metadata entities in the DataHub metadata graph. The entities endpoints support upserting
    entity-aspect pairs, retrieving the latest aspects for a given entity, and performing soft or hard deletes on entities.
  humanURL: https://docs.datahub.com/docs/api/graphql/overview
  baseURL: http://localhost:8080/api/graphql
  tags:
  - Entities
  properties:
  - type: OpenAPI
    url: openapi/datahub-entities-api-openapi.yml
  - type: Documentation
    url: https://docs.datahub.com/docs/api/openapi/openapi-usage-guide
  - type: JSONSchema
    url: json-schema/datahub-metadata-change-log-event-schema.json
- aid: datahub:datahub-platform-api
  name: DataHub Platform API
  description: Write metadata events using the standard platform format. Provides an alternative ingestion path for emitting
    metadata change proposals to the DataHub metadata graph.
  humanURL: https://docs.datahub.com/docs/api/graphql/overview
  baseURL: http://localhost:8080/api/graphql
  tags:
  - Platform
  properties:
  - type: OpenAPI
    url: openapi/datahub-platform-api-openapi.yml
  - type: Documentation
    url: https://docs.datahub.com/docs/api/openapi/openapi-usage-guide
  - type: JSONSchema
    url: json-schema/datahub-metadata-change-log-event-schema.json
- aid: datahub:datahub-relationships-api
  name: DataHub Relationships API
  description: Query the relationship graph to navigate connections between entities. Supports filtering by relationship type
    and traversal direction (incoming or outgoing) from a given entity URN.
  humanURL: https://docs.datahub.com/docs/api/graphql/overview
  baseURL: http://localhost:8080/api/graphql
  tags:
  - Relationships
  properties:
  - type: OpenAPI
    url: openapi/datahub-relationships-api-openapi.yml
  - type: Documentation
    url: https://docs.datahub.com/docs/api/openapi/openapi-usage-guide
  - type: JSONSchema
    url: json-schema/datahub-metadata-change-log-event-schema.json
- aid: datahub:datahub-timeline-api
  name: DataHub Timeline API
  description: Query the versioned history of entity aspects over time. Useful for tracking schema changes, documentation
    updates, and other temporal metadata modifications for a given entity.
  humanURL: https://docs.datahub.com/docs/api/graphql/overview
  baseURL: http://localhost:8080/api/graphql
  tags:
  - Timeline
  properties:
  - type: OpenAPI
    url: openapi/datahub-timeline-api-openapi.yml
  - type: Documentation
    url: https://docs.datahub.com/docs/api/openapi/openapi-usage-guide
  - type: JSONSchema
    url: json-schema/datahub-metadata-change-log-event-schema.json
common:
- type: AgenticAccess
  url: agentic-access/datahub-agentic-access.yml
- type: DomainSecurity
  url: security/datahub-domain-security.yml
- type: Authentication
  url: authentication/datahub-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/datahub/overview
- type: Arazzo
  url: arazzo/datahub-add-glossary-terms-workflow.yml
  name: DataHub Add Glossary Terms to a Dataset
- type: Arazzo
  url: arazzo/datahub-assign-ownership-workflow.yml
  name: DataHub Assign Dataset Ownership
- type: Arazzo
  url: arazzo/datahub-decommission-dataset-workflow.yml
  name: DataHub Decommission a Dataset
- type: Arazzo
  url: arazzo/datahub-emit-and-audit-workflow.yml
  name: DataHub Emit Platform Event and Audit
- type: Arazzo
  url: arazzo/datahub-tag-dataset-workflow.yml
  name: DataHub Tag a Dataset
- type: Arazzo
  url: arazzo/datahub-trace-lineage-workflow.yml
  name: DataHub Trace Dataset Lineage
- type: Arazzo
  url: arazzo/datahub-upsert-dataset-workflow.yml
  name: DataHub Upsert Dataset and Verify
- type: Website
  url: https://datahub.com
- type: Portal
  url: https://docs.datahub.com
- type: Documentation
  url: https://docs.datahub.com/docs/
- type: GettingStarted
  url: https://docs.datahub.com/docs/quickstart
- type: Authentication
  url: https://docs.datahub.com/docs/authentication
- type: GitHubRepository
  url: https://github.com/datahub-project/datahub
- type: Slack
  url: https://slack.datahubproject.io
- type: Blog
  url: https://datahub.com/blog/
- type: Demo
  url: https://demo.datahubproject.io/
- type: ChangeLog
  url: https://github.com/datahub-project/datahub/releases
- type: StatusPage
  url: https://status.datahub.com
- type: Community
  url: https://forum.datahubproject.io/
- type: YouTube
  url: https://youtube.com/@datahubproject
- type: LinkedIn
  url: https://www.linkedin.com/company/datahub-cloud
- type: PrivacyPolicy
  url: https://datahub.com/privacy-policy/
- type: Security
  url: https://docs.datahub.com/docs/security_stance
- type: JSONLD
  url: json-ld/datahub-context.jsonld
- type: Vocabulary
  url: vocabulary/datahub-vocabulary.yml
- type: Capabilities
  url: capabilities/datahub-capabilities.yml
- type: Rules
  url: rules/datahub-rules.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com