> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akta.pro/llms.txt
> Use this file to discover all available pages before exploring further.
# Industry Search API
> Resolves an industry from a free-text query and returns matching industry codes ranked by similarity.
## Overview
The Industry Search API resolves an industry from a free-text query such as say `warehouse automation`and returns a ranked list of matching industry codes and names. Results are ordered by similarity score, so callers can pick the best match or present several candidates to a user. This is a free endpoint and does not consume credits. Results are returned in the API response.
## Endpoint Details
* **Method:** GET
* **Endpoint:** `/v1/industry/search`
## Authentication requirements
* Include a valid API key in the `x-api-key` request header.
## Request
### Request Parameters
#### Header Parameters
Your API key.
## URL Parameters
Free-text industry name or topic to search for. Example: `warehouse automation`
## Request Example
```bash theme={null}
curl -G "https://api.akta.pro/api/v1/industry/search/?query=warehouse%20automation" \
-H "x-api-key: YOUR_API_KEY"
```
## Response
#### Successful Response Fields
Returns a JSON object with the following structure:
List of matching industry objects, ranked by similarity score. Returns an empty array when no matches are found. See **Industry Object Fields** below.
Number of industry objects returned in the `data` array.
Credits consumed by the request. This endpoint is free and always returns `0`.
#### Industry Object Fields
Unique industry code.
Full name of the industry.
Similarity score between the query and the matched industry, ranging from `0` to `1`. Higher values indicate a closer match. Results are returned in descending order of relevance, though scores are not guaranteed to be strictly sorted for ties.
```json 200 expandable wrap theme={null}
{
"data": [
{
"code": "IMAHAHAN",
"industry_name": "Warehouse & Intralogistics Automation Systems (AS/RS, Sortation, Conveyance Controls)",
"similarity": 0.6098
},
{
"code": "IMAHABAK",
"industry_name": "Warehouse Automation Systems (AS/RS, Shuttle Systems, Vertical Lift Modules)",
"similarity": 0.6026
},
{
"code": "HDAAAIAA",
"industry_name": "Industrial & Warehouse Robotics",
"similarity": 0.6004
},
{
"code": "HSAKAKAJ",
"industry_name": "Warehouse & Inventory Relocation (Racking, Pallets, Stock)",
"similarity": 0.5887
},
{
"code": "TLALADAL",
"industry_name": "Automated / Robotics-Enabled Fulfillment Centers (AS/RS, AMRs, Goods-to-Person)",
"similarity": 0.5347
},
{
"code": "IMAIAMAJ",
"industry_name": "Supply Chain & Warehouse Automation (Smart Logistics)",
"similarity": 0.5331
},
{
"code": "HDAEABAK",
"industry_name": "Data Observability & Warehouse Monitoring",
"similarity": 0.5273
},
{
"code": "TLAEABAI",
"industry_name": "WMS for Automation & Robotics Orchestration (WES/WCS Integration)",
"similarity": 0.5225
},
{
"code": "EDAOANAI",
"industry_name": "Warehousing, Inventory & Materials Handling",
"similarity": 0.5157
},
{
"code": "CRAFAMAD",
"industry_name": "Pick/Pack & Value-Added Warehouse Services (Kitting, Returns Prep)",
"similarity": 0.5155
},
{
"code": "IMAHAHAJ",
"industry_name": "Industrial Automation Software (SCADA, HMI, MES, Historian)",
"similarity": 0.5588
},
{
"code": "TLALAAAM",
"industry_name": "Returns & Reverse Logistics Processing Centers (Non-Temp Controlled)",
"similarity": 0.5056
},
{
"code": "BPABABAG",
"industry_name": "Industrial & Warehouse Cleaning (Degreasing, Machine/Plant Cleaning)",
"similarity": 0.5483
},
{
"code": "IMAHABAC",
"industry_name": "Conveyors & Sortation Systems (Warehouse & Parcel)",
"similarity": 0.4909
},
{
"code": "HDAEABAL",
"industry_name": "Data Warehouse/Lakehouse Performance Optimization & Cost Management",
"similarity": 0.4813
},
{
"code": "IMAHAHAL",
"industry_name": "Factory Automation Cells & Integrated Systems (Assembly, Welding, Painting Lines)",
"similarity": 0.5308
},
{
"code": "TLAEABAD",
"industry_name": "WMS for Manufacturing & Production Warehousing",
"similarity": 0.4734
},
{
"code": "TLAEACAI",
"industry_name": "Slotting, Wave/Batch Planning & Release-to-Warehouse",
"similarity": 0.471
},
{
"code": "HSAKAIAD",
"industry_name": "Warehouse-Hosted Portable Storage (Off-Site Storage + Redelivery)",
"similarity": 0.5202
},
{
"code": "HDAEABAA",
"industry_name": "Cloud Data Warehouses",
"similarity": 0.4657
}
],
"count": 20,
"credits_consumed": 0
}
```
## OpenAPI
````yaml GET /v1/industry/search
openapi: 3.0.3
info:
title: Akta.pro API
description: >
Akta provides APIs for company intelligence and news monitoring:
1. **News** – Enriched news articles with AI summaries, sentiment, event
tags, industry classifications, and company mention resolution.
2. **Company Enrichment** – Structured company data including firmographics,
funding, headcount, and financials.
3. **Company Search** – Free endpoint to resolve company names, domains, or
UUIDs.
4. **Product Reviews** – G2 product reviews with ratings and review content.
5. **Employee Reviews** – Employee sentiment data with workplace ratings.
**Authentication:** All endpoints require an API key in the `x-api-key` HTTP
header.
version: 1.0.0
contact:
url: https://akta.pro
servers:
- url: https://api.akta.pro/api
description: Production server
security: []
tags:
- name: News
description: Enriched news articles with AI summaries, sentiment, and company mentions
- name: Company
description: Company data enrichment and search
- name: Reviews
description: Product and employee reviews from external sources
externalDocs:
description: Official Akta.pro API Documentation
url: https://docs.akta.pro
paths:
/v1/industry/search:
get:
tags:
- Company
summary: Industry Search
description: >
Resolves an industry from a free-text query and returns matching
industry codes ranked by similarity.
This is a free endpoint — it does not consume API credits.
operationId: industrySearch
parameters:
- name: query
in: query
required: true
schema:
type: string
description: >-
Free-text industry name or topic to search for. Example: 'warehouse
automation'
responses:
'200':
description: Industry search results returned
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/IndustrySearchResult'
count:
type: integer
description: Number of industry objects returned in the data array.
credits_consumed:
type: number
format: float
example: 0
'204':
description: No content — no industries matched the query.
'400':
description: Bad request — missing or malformed query parameter.
'401':
description: Unauthorized — missing or invalid API key.
security:
- xApiKeyAuth: []
components:
schemas:
IndustrySearchResult:
type: object
properties:
code:
type: string
description: Unique industry code.
industry_name:
type: string
description: Full name of the industry.
similarity:
type: number
format: float
description: >-
Similarity score between the query and the matched industry, ranging
from 0 to 1. Higher values indicate a closer match.
securitySchemes:
xApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key obtained from your Akta account.
````