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.

POST
/v1/organizations/search

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired

Search query

filterarray<object>
matchobject
mustarray<object>
must_notarray<object>
rangeobject
shouldarray<object>
sizeinteger
Minimum: 1Maximum: 200
termsobject
curl -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"
    }
  ]
}