Skip to main content
POST
/
v2
/
organization
/
discover
Python SDK
from revenuebase_sdk import RevenuebaseClient

client = RevenuebaseClient()

result = client.organization.discover(
    keyword="enterprise SaaS cybersecurity",
    result_count=50,
    headquarters_country="US",
)
for org in result.companies:
    print(org.company_name, org.about_us)
{
  "companies": [
    {
      "rbid": "<string>",
      "company_name": "<string>",
      "similar_score": 123,
      "about_us": "<string>",
      "headquarters_street": "<string>",
      "headquarters_city": "<string>",
      "headquarters_state": "<string>",
      "headquarters_zip": "<string>",
      "headquarters_country": "<string>"
    }
  ]
}
Uses semantic search to find organizations matching a keyword or natural-language description. Optionally filter by headquarters location. Returns up to 10,000 results ranked by similarity score. Credits are deducted only for results that meet the min_similarity_score threshold. result_count must be between 1 and 10000 (inclusive). min_similarity_score must be between 0 and 0.95 (inclusive). Defaults to 0.

Authorizations

​
x-key
string
header
required

Body

application/json
​
keyword
string
required
​
result_count
integer
default:1000
​
min_similarity_score
number
default:0

Minimum similarity score (0–0.95). Only results at or above this threshold are returned and charged.

Required range: 0 <= x <= 0.95
​
headquarters_state
string | null
​
headquarters_country
string | null
​
headquarters_city
string | null

Case-sensitive. Must match the city name exactly as stored.

​
headquarters_street
string | null
​
headquarters_zip
string | null

Response

Successful Response

​
companies
Company · object[]
required