Search and Discover Companies in Clodura's Database

The Search Organizations endpoint lets you query Clodura’s company database using a broad set of firmographic and technographic filters. You can target companies by industry sector, annual revenue bracket, headcount range, business model, geographic location, website keywords, and technology stack. The endpoint is the starting point for all company-level workflows: the organisationId values returned here are what you pass to the Enrich Company, Job Posts, and Company News endpoints for deeper intelligence. You must supply at least one filter parameter to execute a search — open-ended queries with no filters are not permitted. Results are paginated, and you can retrieve up to 100 records per page across up to 500 pages.

At least one filter parameter is required (e.g., organisationName, domain, industry, or organisationCountry). Requests with no filters will be rejected.

Endpoint

POST /api/v1/organisation/search

Request

Headers

Header	Value
`X-API-KEY`	Your Clodura API key
`Content-Type`	`application/json`

Body Parameters

array

One or more Clodura company IDs to include in your search. Use this to retrieve specific known companies.

string

The company’s primary domain name (e.g., clodura.ai). Do not include www., @, or any path.

string

The legal or common name of the organization to search for.

array

Filter by one or more cities where the company is headquartered. Refer to the supported cities list.

array

Filter by one or more states. Refer to the supported states list.

array

Filter by one or more countries. Refer to the supported countries list.

boolean

When true, includes companies with any matching office location rather than only headquarters. Defaults to false.

array

Filter by industry sector. Refer to the supported industries list.

array

Specialized industry keywords or company specialties (e.g., AI, FinTech, SaaS).

array

Filter by primary business model. Accepted values: Product, Service, Solutions.

array

Filter by estimated annual revenue bracket. Accepted values: < 1M, 1M-10M, 11M-100M, 101M-500M, 501M-1B, 1B+.

array

Filter by headcount range. Accepted values: 0 - 1, 2 - 10, 11 - 50, 51 - 200, 201 - 500, 501 - 1000, 1001 - 5000, 5001 - 10000, 10000+. Note: values must include spaces around the hyphen.

array

Keywords found on the company’s public website content (e.g., CRM, machine learning, compliance).

array

Technologies used by the company. Refer to the supported technologies list.

integer

Page number for pagination. Maximum: 500.

integer

Number of results to return per page. Maximum: 100.

Example Request

curl --request POST \
  --url https://api.clodura.ai/api/v1/organisation/search \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "industry": ["Technology"],
    "organisationCountry": ["United States"],
    "revenue": ["11M-100M"],
    "organisationEmployeeSize": ["51 - 200"],
    "businessModel": ["Product"],
    "page": 1,
    "perPage": 20
  }'

import requests

url = "https://api.clodura.ai/api/v1/organisation/search"

headers = {
    "X-API-KEY": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "industry": ["Technology"],
    "organisationCountry": ["United States"],
    "revenue": ["11M-100M"],
    "organisationEmployeeSize": ["51 - 200"],
    "businessModel": ["Product"],
    "page": 1,
    "perPage": 20
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response

A successful 200 response returns a paginated list of matching organizations.

object

Show pagination fields

integer

The current page number.

integer

Number of records returned per page.

integer

Total number of companies matching your filters.

integer

Total number of pages available.

array

Show organisation object fields

string

Clodura’s unique identifier for the company. Use this value as organisationId in Enrich Company, Job Posts, and Company News requests.

string

The company’s name.

string

The company’s primary web domain.

string

The company’s LinkedIn page URL.

string

The company’s primary industry.

string

Year the company was founded.

string

Headcount range (e.g., 51 - 200).

string

City of the company’s headquarters.

string

State of the company’s headquarters.

string

Country of the company’s headquarters.

string

A short description of the company.

Example Response

{
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_entries": 1250,
    "total_pages": 63
  },
  "organisations": [
    {
      "id": "2389402640191586304",
      "name": "Clodura.AI",
      "primary_domain": "clodura.ai",
      "linkedin_url": "https://www.linkedin.com/company/clodura-ai/",
      "industry": "Technology",
      "founded_year": "2015",
      "organisationEmployeeSize": "51 - 200",
      "city": "Pune",
      "state": "Maharashtra",
      "country": "India",
      "description": "Clodura is an AI-powered sales intelligence platform..."
    }
  ]
}

Save the id field from search results — you will need it as organisationId in all subsequent company-level API calls.

Error Codes

Status	Meaning
`400`	Bad request — domain count exceeds 10 or malformed input
`401`	Unauthorized — your API key is missing or invalid
`402`	Payment required — credits exhausted; upgrade your plan or add credits
`403`	Forbidden — this endpoint requires a paid Clodura plan
`404`	No results found — try broadening or adjusting your filters
`409`	Daily rate limit reached — maximum API calls for this endpoint exceeded
`422`	Unprocessable entity — invalid parameter combination or malformed JSON body
`429`	Rate limit exceeded — reduce request frequency or upgrade your plan

Overview

People API

Company API

Search and Discover Companies in Clodura's Database

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

Error Codes

​Endpoint

​Request

​Headers

​Body Parameters

​Example Request

​Response

​Example Response

​Error Codes

Endpoint

Request

Headers

Body Parameters

Example Request

Response

Example Response

Error Codes