Resolve an industry from a free-text query into matching industry codes ranked by similarity.
Overview
The Industry Search API resolves a free-text industry or topic name into a ranked list of matching industry codes. Its primary purpose is to look up the code needed as the industry parameter in the News API or List Generation API when you only have a topic name to start with, not an akta.pro industry code. This is a free endpoint so it does not consume API credits. Endpoint
GET https://api.akta.pro/api/v1/industry/search
Pass a query parameter to search, and an optional level parameter to restrict results to specific tiers of akta.pro industry taxonomy. The backend matches query against the taxonomy and returns the closest industries, ranked by similarity.
Authentication
All requests must include an API key in the x-api-key HTTP header.
x-api-key: <YOUR_API_KEY>
Never expose your API key in client-side code, browser requests, or public repositories. A missing or invalid key returns 401 Unauthorized.
Request Reference
Parameter
Type
Required
Description
query
string
Required
Free-text industry name or topic (e.g. "warehouse automation"). The API matches this against Akta’s industry taxonomy and returns the closest codes.
level
string
Optional
One or more taxonomy levels to restrict results to. Accepts a single value or a comma-separated list (e.g. "l4,l1"). Available values: l1, l2, l3, l4, all. Default is l4 — the most granular taxonomy tier. Pass all or a specific combination of levels to widen results to broader industry groupings as well.
Searching across multiple taxonomy levelsBy default, results are restricted to l4 (the most granular level). Pass level with multiple values, or all, to also surface broader, higher-level industry groupings in the same call:
Array of matching industry objects, ranked by similarity score. Empty array [] when no results are found.
count
integer
Number of industry objects returned in the data array.
credits_consumed
float
Always 0 — this is a free endpoint.
Industry object
Field
Type
Description
code
string
Unique Akta industry code. Pass this as the industry parameter in the News API.
industry_name
string
Full name of the industry as per Akta’s industry taxonomy.
similarity
float
Similarity score between the query and the matched industry, from 0 to 1. Higher values indicate a closer match. Results are returned in descending order of relevance.
Using the code in other APIs
Once you have the code, pass it as the industry field in downstream API calls:
import requestsHEADERS = {"x-api-key": "<YOUR_API_KEY>"}# Step 1: Search for the industrysearch = requests.get( "https://api.akta.pro/api/v1/industry/search", headers=HEADERS, params={"query": "warehouse automation"})code = search.json()["data"][0]["code"]# Step 2: Use the code in the News APInews = requests.get( "https://api.akta.pro/api/v1/news", headers=HEADERS, params={"industry": code, "limit": 10})print(f"Found {news.json()['total']} articles")
If a query matches several closely related industries, consider passing more than one code to the News API’s industry parameter (comma separated) to widen coverage, rather than relying on the single top match.
If the default l4 results feel too narrow or too specific for your use case, pass level=all (or a specific combination like level=l3,l4) to also pull in broader taxonomy groupings before deciding which code(s) to use downstream.