API Documentation

Access OSINT Library data programmatically via our REST API

API Keys

Create Account

Authentication

All API endpoints can be accessed without authentication. Authenticated requests have higher rate limits.

Authorization: Bearer osl_your_api_key_here

Without API Key

60 requests/minute per IP

With API Key

Up to 1000 requests/minute

Endpoints

GET/api/v1/tools

List and search tools with filters

Query Parameters

searchstring

Search query

pricingstring[]

Filter by pricing (FREE, PAID, FREEMIUM)

platformsstring[]

Filter by platform (WEB, CLI, API, ...)

conceptIdsstring[]

Filter by concept UUIDs

investigationTypeIdsstring[]

Filter by investigation type UUIDs

pagenumber

Page number (default: 1)

pageSizenumber

Items per page (default: 24, max: 100)

GET/api/v1/tools/:slug

Get a single tool by slug

GET/api/v1/concepts

List all concepts with optional group and role filters

Query Parameters

groupIdstring

Filter by concept group UUID

rolestring

Filter by role (INPUT, OUTPUT, TAG)

GET/api/v1/investigation-types

List all investigation types with tool counts

GET/api/v1/search

Global search across tools, concepts, and investigation types

Query Parameters

qstring

Search query (min 2 chars)

Example

# Search for free tools
curl "https://osintlibrary.com/api/v1/tools?search=email&pricing=FREE" \
  -H "Authorization: Bearer osl_your_key"

# Get tool details
curl "https://osintlibrary.com/api/v1/tools/sherlock"

# Search across everything
curl "https://osintlibrary.com/api/v1/search?q=social+media"