Welcome to the Fusionbase Public API, your gateway to programmatically accessing a rich ecosystem of data streams. Before diving into the API, we recommend beginning your journey on our website to explore the vast array of data available to you.

Step 1: Explore Data on the Fusionbase Website

Discovering Data Streams

Visit the Hub to browse through the datasets. Here you can:

• Search for topics that interest you.

• Preview data to understand its structure and contents.

• Identify the datasets that can provide the insights you need.

Take your time to explore. Once you find the data that aligns with your goals, note the Stream ID – you'll use this when interacting with the API.

Step 2: Programmatically Access Data with the API

Authenticate with Your API Key

To start using the API:

1. Obtain your API key from the page in your Fusionbase account.

2. Use the X-API-KEY header to authenticate your API requests.

Base URL for API Requests

For all your API calls, use the base URL:

Retrieving Your Selected Data Stream (or Any Other Data Entity)

After identifying the data you want from our website, you can retrieve it programmatically via the API endpoint:

Replace [Stream ID] with the ID of the data stream you've selected.

Code Snippets for API Access

We provide a variety of code snippets to help you make your first API request in the language of your choice. Visit our for examples in Python, NodeJS, Java, C#, and more.

Step 3: Integrate Data into Your Applications

Once you have successfully made requests using our sample code, it's time to integrate Fusionbase data streams into your applications. This allows you to automate data retrieval and keep your applications enriched with the latest data.

Need Help?

If you encounter any issues or have questions as you explore and use the Fusionbase API, our support team is ready to assist you. Contact us via our .

Empowering Data Exploration and Integration

At Fusionbase, we believe that working with data, particularly in its exploration and integration, should be both exciting and straightforward. Our API is crafted to support the daily workflows of data scientists and engineers with efficiency and ease.

Designed with REST Principles for Predictability and Simplicity

The Fusionbase API embraces RESTful principles, ensuring a consistent and intuitive experience:

• Resource-Oriented URLs: Navigate our API with clear, logical, and predictable URLs.

• Form-Encoded Requests: Easily send requests in a widely-used, structured format.

• JSON-Encoded Responses: Receive responses in a universally compatible and readable JSON format.

Getting Started is Easy!

Quick-Start Guides: Ready to dive in? If you're keen to get started right away, our quick-start guides are the perfect place to begin. Make your first API request and see the immediate results:

Comprehensive API Reference: Looking for detailed information? Our comprehensive API reference provides an in-depth look at all the functionalities and possibilities of the Fusionbase API. Explore at your own pace and discover everything our API offers:

We're Here to Help

Have questions or need some guidance? We're here to assist you every step of the way. Feel free to reach out to our support team for any inquiries or assistance you might need:

Let's Start Your Data Journey!

Whether you're just beginning or ready to deep dive into complex data tasks, Fusionbase is here to make your data journey enjoyable and successful. Explore, integrate, and transform data like never before with Fusionbase API.

The Fusionbase Data Hub Search API is tailored for developers seeking to harness a wealth of data for various applications. This robust API simplifies access to a diverse range of data entities, each offering unique insights and opportunities for integration:

1. Data Streams: Access real-time and historical datasets encompassing areas like statistics, environmental data, and public records. Ideal for applications in analytics, trend monitoring, and data-driven decision-making.

2. Data Services: Discover APIs and services for data processing and analytics. These services are crucial for enhancing data quality, interpretation, and application in your projects.

3. Organizations: Explore detailed information about companies, going beyond mere registry data to include insights into business operations, market presence, and industry standing. This entity is invaluable for market analysis, competitive intelligence, and B2B solutions.

4. Persons: Access official records of individuals in professional contexts, specifically those associated with organizations. This data is essential for network analysis, professional background checks, and organizational research.

5. Locations: Utilize comprehensive geographical and locational data, useful for mapping, logistics planning, and geographical analysis.

6. Relations: Investigate the connections between different entities, providing a deeper understanding of organizational networks, geographical correlations, and data context.

Search Endpoints:

• Fusion Search Endpoint: An AI-driven, comprehensive search across all entities, ideal for broad queries where user intent is analyzed and results are ranked accordingly. This endpoint is particularly useful when the search context is not entity-specific and a holistic view is desired.

Entity-Specific Endpoints:

1. Streams and Services Endpoint: Focuses on datasets and data-related services, suitable for applications needing specific data types or analytics services.

2. Organizations Endpoint: Dedicated to detailed company information, perfect for business intelligence and market research.

3. Persons Endpoint: Targets professional profiles and official records, ideal for background checks and professional network analysis.

Practical Application and Integration:

As a developer, you can expect the Fusionbase Data Hub Search API to be a reliable and comprehensive source for various types of data. Whether your project involves creating sophisticated market analysis tools, developing rich data visualizations, or integrating background information into professional networking platforms, this API provides the necessary data foundation.

The Fusionbase Data Hub is designed with the developer in mind, ensuring ease of integration, consistent data quality, and a wide range of data types to meet diverse application needs. By incorporating this API into your projects, you can significantly enhance your application's capabilities, offering users deeper insights and more valuable experiences.

Projections

GET https://api.fusionbase.com/api/v2/stream/data/{STREAM_ID}?format=json&query_parameters={ "project_fields": ["FIELD_NAME"]}

If you are only interested in a subset of columns in a Data Stream you can project them. Therefore, the result set does not contain any additional columns. Specifically, in cases when the Data Stream has a large number of columns, this can significantly speed up the retrieval performance.

The Fusionbase API provides streamlined access to data streams, offering specialized endpoints for retrieving metadata, querying data, and conducting string searches within the data. Access to these features is achieved through authenticated GET requests.

Fusionbase Data Hub is structured around key data entities, providing specialized APIs to access structured data for each entity type. The primary entities are ORGANIZATION, PERSON, EVENT, and LOCATION.

Organizations

Represents a structured profile of a company or institution. The data for an ORGANIZATION includes essential information such as the company name, location and industry (if applicable). It may also cover legal status, history, and various operational aspects. The API for ORGANIZATION entities is designed to offer comprehensive insights into businesses and institutions, making it valuable for market research, business intelligence, and due diligence processes.

Sorting

GET https://api.fusionbase.com/api/v2/stream/data/{STREAM_ID}?query_parameters={"sort_order": ["asc"], "sort_keys": ["fb_datetime"]}&format=json

The Data Stream can be sorted by any column in ascending or descending order. Sorting by multiple columns at once is also possible.

The Fusionbase API offers a sophisticated mechanism for retrieving entries based on their version. This is particularly useful for accessing data that is newer than a specific version or within a range of versions. The version_boundary parameter in the API request facilitates this functionality.

Let's assume a Data Stream is updated five times a day and you decide to pull the data just once a day. To get all of the newly added records from your local version up to the most recent version of the Data Stream, simply use the delta endpoint.

Get records from a certain version

The Person Search Endpoint is a specialized tool designed for retrieving detailed personal profiles from official business registry sources. This powerful endpoint is essential for applications requiring in-depth information about individuals, particularly in business contexts, such as their roles in organizations, location, and professional relationships. It is a valuable resource for developers building applications for business intelligence, network analysis, or compliance purposes.

Example: Using the Person Search Endpoint

To search for an individual, a GET request is made to the Person Search Endpoint. This endpoint accepts the person's name or other identifiers as query parameters. It returns a JSON object with comprehensive personal data, extracted exclusively from official business registry sources.

API requests are authenticated using API keys which are sent via the custom X-API-KEY header. Any request that doesn't include an API key will return an authentication error.

You can view and manage your API keys at the page in your Fusionbase account.

All API requests must be made over HTTPS. Calls made over plain HTTP will be redirected to HTTPS. API requests without authentication will fail.

Filter the data stream

GET https://api.fusionbase.com/api/v2/stream/data/{STREAM_ID]?query_parameters={"filters": [{"property": "construction_year_end", "operator": "GREATER_THAN", "value": 2013}]}&format=json

The actual values of a Data Stream can be queried and filtered using the

Pagination

GET https://api.fusionbase.com/api/v2/stream/data/{STREAM_ID}?skip=0&limit=2&format=json

Some Data Streams are too large to get all the records via the API in a single call. In such cases the API lets you paginate the results via the skip

The Location Search Endpoint is your comprehensive solution for place searches and address geocoding, akin to the functionality of Google Maps Places Search. Whether you're plotting points of interest or transforming addresses into coordinated data, this endpoint delivers accurate, map-ready results. It's the developer's tool of choice for creating location-aware applications with high precision and reliability.

Example: Using the Location Search Endpoint for Geocoding

To geocode an address such as "Agnes-Pockels-Bogen 1, 80992 München", you would make a GET request to the Location Search Endpoint. The endpoint takes the address as a query parameter and returns a JSON object with the geocoded location details, including latitude and longitude coordinates.

The Relations Endpoint is a powerful feature of Fusionbase API, designed to resolve and map the complex web of relationships between various entities and data features. This endpoint is particularly useful for understanding the network of connections surrounding an entity, be it a person or an organization. It is an invaluable tool for applications focusing on network analysis, relationship mapping, and comprehensive data linkage.

Example: Using the Relations Endpoint

To resolve relations for a specific entity, a POST request is made to the Relations Endpoint with the relation ID and entity ID. This endpoint efficiently maps the network of connections related to the given entity, providing insights into their professional and organizational links.

The Organization Search Endpoint is a dynamic solution for searching organizational data and extracting specific business information. This endpoint is ideal for applications requiring detailed information about various organizations. It provides robust data for developers building applications that require comprehensive business information, such as company names, statuses, addresses, and registration details.

Example: Using the Organization Search Endpoint

To search for an organization, a GET request is made to the Organization Search Endpoint. The endpoint accepts the organization's name or other identifying details as query parameters. In response, it returns a JSON object containing detailed information about the organization, including its status, address, registration details, and more.

The /api/v2/entities/location/get/{FB_ENTITY_ID} endpoint in the Fusionbase API provides structured information about specific locations. This endpoint is crucial for accessing detailed and structured data about locations using their unique Fusionbase Entity ID (FB_ENTITY_ID).

Request Header

The Streams & Services Search Endpoint is a specialized API endpoint designed to streamline searches specifically for Data Streams and Data Services within the Fusionbase Data Hub. It efficiently narrows down results to these two categories, delivering precise data sets and related services. Perfect for developers who need to target their search for datasets, like statistics or environmental data, and services that complement data processing and analytics, providing a focused and detailed data selection.

Data Search

GET https://api.fusionbase.com/api/v2/search/data?q=<QUERY>

Query Parameters

To assist with integrating the Streams & Services Search API into your application, we provide examples in various programming languages. Each example illustrates how to execute a properly encoded GET request to the API. Remember to replace <QUERY> with your URL-encoded search query and YOUR_API_KEY with the actual API key provided to you.

These code snippets provide a template for making a GET request to the Streams & Services Search endpoint of the Fusionbase Data Hub API. By encoding the query parameter, you ensure that the request is correctly formatted and can be processed efficiently by the API.

The /api/v2/entities/person/get/{FB_ENTITY_ID} endpoint in the Fusionbase API is designed to provide structured information about specific individuals. This endpoint is crucial for accessing detailed and structured data about persons using their unique Fusionbase Entity ID (FB_ENTITY_ID).

Request Headers

• X-API-KEY: Your Fusionbase API key. This key is required for authenticating your access to the API.

• Content-Type: application/json. This header specifies the format of the request.

Request Structure

• The endpoint is accessed via a GET request to https://api.fusionbase.com/api/v2/entities/person/get/{FB_ENTITY_ID}.

• {FB_ENTITY_ID} should be replaced with the actual Fusionbase Entity ID of the person you are querying.

Request Sample

Response Structure

The response is a JSON object containing various details about the person:

• fb_entity_id: The Fusionbase Entity ID uniquely identifying the person.

• fb_datetime: Timestamp indicating when the data was last updated or retrieved.

• fb_entity_version: A version identifier for the entity's data.

Response Sample

Error Handling

The API uses standard HTTP response codes. Errors are indicated with 4xx (client errors) and 5xx (server errors), each accompanied by a message detailing the issue.

Notes

• Keep the API key confidential.

Installation in Python - PyPI release

Fusionbase is on PyPI, so you can use pip to install it.

If you want to use all features, you must make sure that pandas and numpy are installed.

Fusionbase by default uses the standard JSON library of Python to serialize and locally store data. However, you can use the faster orjson library as a drop-in replacement.

Therefore, just install orjson and Fusionbase will automatically detect and use it.

Getting Started

Got to to deep dive into Fusionbase and see various examples on how to use the package.

Here are some Examples for a quick start:

Data Streams

The Data Stream module lets you conveniently access data and metadata of all Data Streams. Each stream can be accessed via its unique stream id or label.

Setup

Human readable datastream information

Getting the data

The samples below show how to retrieve the data of a datastream as a list of dictionaries. Each element in the list represents one row within the dataset.

Note that the data can by hierarchical.

Get Data as a DataFrame

If you are working with pandas, it is probably the most convenient way to load to data directly as a pandas DataFrame.

Storing the data

Large datasets potentially do not fit into the memory. Therefore, it is possible to get the data of a stream directly as partitioned files.

The folder structure is automatically created and always like ./{ID-OF-THE-STREAM}/data/*

Data Services

A data service can be seen as an API that returns a certain output for a specific input. For example, our address parses an address and returns the structured and normalized parts of it.

Setup

Human readable data service information:

Human readable data service definition:

Invoke a data service:

Our Data Service API functions as an interface that delivers specific outputs in response to defined inputs. It is designed to streamline the process of retrieving targeted data efficiently and accurately.

Example: Web Context Service for Organizations

Functionality: The Web Context Service for Organizations is a specialized feature of our Data Service API. It is engineered to collect and return comprehensive, publicly available information about various companies.

How It Works:

• Input: You provide the base data of an organization.

• Process: The service searches through an extensive database of public records and digital resources.

• Output: It returns a detailed compilation of information about the specified company. This may include company size, location, industry, and other relevant organizational data.

Use Case: This service is particularly useful for market researchers, financial analysts, and business development professionals who need quick and reliable access to company profiles and industry data.

There is only a single endpoint to access services through Fusionbase:

Invoke data service

POST https://api.fusionbase.com/api/v2/service/invoke

Takes the service specific input values and returns the result of the service.

Request Body

Example

All services are used in the exact same way. Let's take the as an example on how to use them via the API.

The Company Web Context Service is designed to retrieve and compile comprehensive internet-based information about specific companies.

Key Features:

• Input Parameters: The service requires four input values: entity_name, postal_code, street and city

• Service ID: This service is identified by the ID 4658603456.

Example Usage: To invoke this service for "OroraTech GmbH" located in the zip code area "81669", a POST request can be made as follows:

The /api/v2/chat/completions endpoint of the Fusionbase API is designed to generate chat completions based on a given context and a series of messages. This endpoint is particularly useful for obtaining context-aware responses in a conversational format.

Request Headers

• Content-Type: application/json

• X-API-KEY: Your Fusionbase API key.

Request Body

• model (required): String. Specifies the model to be used for generating completions. For example, "fusion-one".

• linked_context (optional): Array of Objects. Each object represents a context entity linked to the chat.

  • type: String. The type of the linked context entity (e.g., "ORGANIZATION", "PERSON").

Request Samples

Response Structure

• id: A unique 32-character alphanumeric hash identifying the completion request.

• object: String, indicating the type of the object, here "chat.completion".

• created: Unix timestamp indicating the creation time of the response.

Response Sample

Error Handling

The API uses standard HTTP response codes. Errors are indicated with 4xx (client errors) and 5xx (server errors), each accompanied by a message detailing the issue.

Notes

• Keep the API key confidential.

• Context and message relevance is crucial for accurate results.

The /api/v2/entities/organization/get/{FB_ENTITY_ID} endpoint in the Fusionbase API provides structured information about specific organizations. This endpoint is essential for retrieving detailed and structured data about companies using their unique Fusionbase Entity ID (FB_ENTITY_ID).

Request Header