# Company Search Endpoint

The **Company Search** endpoint lets you **find and list companies** based on flexible filters (name, domain, industry, size, location, keywords, etc.).\
Use it when you **don’t have a Social URL** yet and need to discover or shortlist the right companies before enrichment.

| Aspect       | Description                                                                                                                                                                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Purpose**  | Discover companies that match your criteria and return them as structured company objects.                                                                                                                                                           |
| **Input**    | Any combination of filters such as: **company name**, **domain**, **industry**, **size range**, **location** (city/region/country), and **keywords**. Supports **pagination** and optional **sorting** (e.g., relevance, followers, employee count). |
| **Output**   | A **list of company objects** plus **metadata** (pagination cursors/pages, total count if available) and optional **match/relevance scores**.                                                                                                        |
| **Credits**  | Typically **1 credit** per successful call (or per page), depending on your billing policy.                                                                                                                                                          |
| **Best for** | Account discovery, market mapping, ABM list building, territory planning, data QA before enrichment.                                                                                                                                                 |

### Objects Structure

#### Company object

* **Company Identity** — Name, **Social URL**, normalized handle/ID, and domain.
* **Size & Reach** — Employee count and **size range**; follower/subscriber counts when available.
* **Web & Brand** — Website URL, industry classification, **tagline**, **description**, and specialties (keywords).
* **Headquarters & Basics** — HQ location (city/region/country), and **founded year**.
* **Media & Visuals** — Logo and cover/background image URLs when present.

{% hint style="warning" %}
**Important Notice**

This documentation is only a **preview** of our API. It provides a high-level overview of what the API can do and which types of data objects you can expect.\
\
The **official API Reference** — including full technical specifications, JSON schemas, sample results, error codes, and authentication details — is only available after signing up to our platform.\
\ <a href="https://app.scrapin.io/auth/register" class="button primary">Sign up to access the full API Reference</a>
{% endhint %}