GuidesAPI Reference
Guides
App ShowcaseAPI Trial

Vainu API Overview

Introduction to the Vainu API and its capabilities

Welcome to the Vainu API documentation. The Vainu API provides programmatic access to Vainu's comprehensive business intelligence database, allowing you to search, filter, and analyze company information at scale.

Vainu’s own platform https://vainu.app is built using the exact same APIs available to our customers.

What You Can Do with Vainu API

The Vainu API enables you to:

  • Search and Filter - Query companies using advanced filtering capabilities based on industry, location, size, technology stack, and custom criteria
  • Hundreds of structured datapoints - Select any of the datapoints in the data catalogue to be returned along your search
  • Vainu Agents - Use Vainu Agents to analyze the company based on everything Vainu has collected on this company. Uses both structured and unstructured data for analysis.
  • Export Data - Download large datasets in multiple formats (JSON, CSV, JSONL, XLSX)
  • Process Asynchronously - Handle large-scale data operations with long-running async tasks. Even full country databases with one run.
  • Track Changes - Monitor modifications to company data with timestamp-based queries
  • Analyze Statistics - Get aggregated insights and statistics of companies

Key Features

Multiple Authentication Methods

  • JWT Authentication - Token-based authentication for API access
  • Client Credentials - OAuth 2.0 Client Credentials flow for applications
  • Trial Tokens - Limited-time tokens for evaluating the API

Flexible Data Filtering

  • Advanced query language with operators for complex filtering
  • Support for field-based searches and modifications tracking
  • Aggregation capabilities for data summarization

Performance and Scale

  • Synchronous requests for immediate responses (2-minute timeout)
  • Asynchronous operations for long-running queries
  • Multiple response formats optimized for different use cases
  • Rate limiting and concurrent request management

Comprehensive Data Coverage

  • Access to companies across multiple countries (FI, SE, NO, DK, NL)
  • Hundreds of data points for every company
  • Continuous data updates and modifications tracking

Getting Started

To start working with the Vainu API:

  1. Authenticate with either JWT or Client Credentials
  2. Quick start and test out a query Learn about request structure and parameters
  3. Explore filtering capabilities for your queries
  4. Understand response formats

Response Format

Responses from Vainu API are returned in JSON format by default, with support for additional formats like CSV, JSONL, and XLSX for async operations.

💡

For detailed information about available data fields and their definitions, visit the Data Catalogue