Developer Docs

API Documentation

Programmatic access to 1.3 million verified European B2B suppliers. REST API with JSON responses.

Authentication

All API requests require an API key passed in the Authorization header.

Authorization: Bearer your-api-key

API keys are coming soon. Join the waitlist by registering your business.

Base URL

https://btob.dev/api/v1

Endpoints

GET/suppliers/search

Keyword search for suppliers by name, product, service, or industry.

Parameters

  • q(required) — search query string
  • country— ISO 3166-1 alpha-2 country code filter
  • limit— results per page (default: 20, max: 100)
GET/suppliers/semantic

Natural language semantic search. Describe what you need and get the best matches.

Parameters

  • q(required) — natural language description
  • limit— results per page (default: 20, max: 100)
GET/suppliers/:id

Get the full profile for a specific supplier by UUID.

GET/industries

List all industry categories in the index.

GET/countries

List all supported European countries.

OpenAPI Specification

The full OpenAPI 3.1 spec is available at /openapi.json. Import it into Postman, Insomnia, or any OpenAPI-compatible tool.

Agent Integration

For AI agent integration via MCP, see the MCP integration guide. For LLM-readable context, see /llm.txt.