# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.scrapin.io/api/readme-4.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.