Search Companies
Beta endpoint
This endpoint is in BETA and subject to change. It's not recommended to use it for production applications.
Search for companies.
Authorization
Authorization
RequiredBearer <token>In: header
Request Body
application/json
RequiredSearch query
filter
array<object>match
objectmust
array<object>must_not
array<object>range
objectshould
array<object>size
integerMinimum:
1
Maximum: 200
terms
objectcurl -X POST "https://api.surfe.com/v1/organizations/search" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"filter": [
{
"filter": [
{}
],
"match": {
"property1": {
"fuzziness": "string",
"operator": "string",
"query": "string"
},
"property2": {
"fuzziness": "string",
"operator": "string",
"query": "string"
}
},
"must": [
{}
],
"must_not": [
{}
],
"range": {
"property1": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
},
"property2": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
}
},
"should": [
{}
],
"terms": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}
],
"match": {
"property1": {
"fuzziness": "string",
"operator": "string",
"query": "string"
},
"property2": {
"fuzziness": "string",
"operator": "string",
"query": "string"
}
},
"must": [
{
"filter": [
{}
],
"match": {
"property1": {
"fuzziness": "string",
"operator": "string",
"query": "string"
},
"property2": {
"fuzziness": "string",
"operator": "string",
"query": "string"
}
},
"must": [
{}
],
"must_not": [
{}
],
"range": {
"property1": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
},
"property2": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
}
},
"should": [
{}
],
"terms": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}
],
"must_not": [
{
"filter": [
{}
],
"match": {
"property1": {
"fuzziness": "string",
"operator": "string",
"query": "string"
},
"property2": {
"fuzziness": "string",
"operator": "string",
"query": "string"
}
},
"must": [
{}
],
"must_not": [
{}
],
"range": {
"property1": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
},
"property2": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
}
},
"should": [
{}
],
"terms": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}
],
"range": {
"property1": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
},
"property2": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
}
},
"should": [
{
"filter": [
{}
],
"match": {
"property1": {
"fuzziness": "string",
"operator": "string",
"query": "string"
},
"property2": {
"fuzziness": "string",
"operator": "string",
"query": "string"
}
},
"must": [
{}
],
"must_not": [
{}
],
"range": {
"property1": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
},
"property2": {
"gt": 0,
"gte": 0,
"lt": 0,
"lte": 0,
"relation": "intersects"
}
},
"should": [
{}
],
"terms": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}
],
"size": 1,
"terms": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}'
List of found companies
{
"organizations": [
{
"addresses": [
{
"isPrimary": true,
"raw": "526 Coyote Road, CA, USA"
}
],
"annualRevenueRange": "10-50M",
"description": "The Acme Corporation is a fictional corporation that features prominently in the Road Runner/Wile E. Coyote animated shorts as a running gag. The company manufactures outlandish products that fail or backfire catastrophically at the worst possible times.",
"digitalPresence": [
{
"name": "X (Previously Twitter)",
"url": "https://x.com/acmeorg"
}
],
"externalID": "external-id",
"followersCountLinkedin": 1000000,
"founded": "1920",
"fundingRounds": [
{
"amount": 2,
"amountCurrency": "USD",
"announcedDate": "1920-01-01",
"leadInvestors": [
"Coyote",
"Road Runner"
],
"name": "Seed round"
}
],
"industries": [
{
"SubIndustry": "Commodity Chemicals",
"group": "Materials",
"industry": "Chemicals",
"sector": "Materials"
}
],
"ipo": {
"date": "1920-01-01",
"sharePrice": 1,
"sharePriceCurrency": "USD"
},
"isPublic": true,
"keywords": [
"American",
"Corporations",
"Manufacture",
"Everything"
],
"linkedinUrl": "https://www.linkedin.com/company/acmeorg/",
"logoUrl": "www.acme.org/logo.jpeg",
"name": "Acme Corporation",
"parentOrganization": {
"name": "Cyberdyne Systems",
"website": "skynet.org"
},
"phones": [
"555-555-555",
"555-555-5554"
],
"size": 100,
"stocks": [
{
"exchange": "NASDAQ",
"ticker": "ACME"
}
],
"website": "www.acme.org"
}
]
}