Get Finder Category IDs

Get category IDs from Finder autocomplete. Categories: industries, organizations, organization_keywords, locations, person_skills, web_technologies. Returns results with id and text. IMPORTANT: Use this tool BEFORE analyzeICPTotalCount or createIcpMining when the user mentions industries, locations, job skills, etc. - those tools require IDs, not free text. Search with q to find the correct ID.

Input Schema

Parameter	Type	Description
category	string	Category to search: industries, organizations, organization_keywords, locations, person_skills, web_technologies. Enum: industries, organizations, organization_keywords, locations, person_skills, web_technologies
q	string	Search term (e.g. “technology”, “New York”, “Marketing Manager”) to find matching IDs
page	number	Page number for pagination (default 1)

REST Endpoint


POST /api/agents/tools/getFinderCategoryIds


POST /api/agents/tools/getFinderCategoryIds
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "category": "industries",
  "q": "technology",
  "page": 1
}

Response:


{
  "success": true,
  "category": "industries",
  "data": {
    "results": [
      { "id": 123, "text": "Information Technology" },
      { "id": 456, "text": "Technology & Software" }
    ]
  }
}