Skip to main content
POST
/
v1
/
enrichment
/
companies
/
search
Company Search
curl --request POST \
  --url 'https://api.scrapin.io/v1/enrichment/companies/search?apikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "companyName": "<string>",
  "industry": [
    "Software Development",
    "IT Services and IT Consulting"
  ],
  "employeeCountMin": 50,
  "employeeCountMax": 500,
  "locationCity": "<string>",
  "locationCountryCode": "US,GB,FR",
  "updateDate": "30d",
  "page": 1
}
'
{ "success": true, "credits_consumed": 0.1, "credits_left": 9999.9, "rate_limit_left": 4999, "daily_rate_limit_left": 4999, "minute_rate_limit_left": 497, "next_minute_rate_limit_reset": "2026-01-15T10:30:00.000Z", "quotas": { "credits": { "total": 10000, "used": 0.1, "left": 9999.9 }, "daily_rate_limit": { "limit": 5000, "used": 1, "left": 4999, "next_reset": "2026-01-16T00:00:00.000Z" }, "minute_rate_limit": { "limit": 500, "used": 3, "left": 497, "next_reset": "2026-01-15T10:30:00.000Z" } }, "metadata": { "source": "cache", "request_id": "cb7b2a9b-7541-4b3c-9b45-8e5c762875e4" }, "pagination": { "currentPage": 1, "totalPages": 5, "totalResults": 87, "resultsPerPage": 20 }, "companies": [ { "linkedInId": "12345678", "name": "Acme Corp", "universalName": "acme-corp", "linkedInUrl": "https://www.linkedin.com/company/12345678", "industry": "Software Development", "employeeCount": 450, "employeeCountRange": { "start": 201, "end": 500 }, "followerCount": 12500, "websiteUrl": "https://www.acme-corp.com", "tagline": "Building the future of enterprise automation." }, { "linkedInId": "87654321", "name": "Nova Technologies", "universalName": "nova-technologies", "linkedInUrl": "https://www.linkedin.com/company/87654321", "industry": "IT Services and IT Consulting", "employeeCount": 35, "employeeCountRange": { "start": 11, "end": 50 }, "followerCount": 2800, "websiteUrl": "https://www.novatech.io", "tagline": null } ] }
Each search costs 0.10 credits per page (maximum 20 results per page). Perfect for bulk company discovery and market research.

​
Overview

Search for companies in our DataLake using advanced filters. This endpoint allows you to find multiple companies matching specific criteria from our existing database.
DataLake Search: This endpoint searches our existing database with historical data. Check the updateDate field in each result to see when the company was last refreshed.

​
Need Fresh Data?

The search results include an updateDate field showing when each company was last updated. If you can’t find companies recent enough even with the updateDate filter, you can get live, real-time data using:

Company Profile Data

Extract fresh company data directly in real-time from the company LinkedIn URL.
Smart Workflow: Use Company Search to discover companies, then check the updateDate. If the data is recent enough (e.g., within last 30 days), use it directly. If not, fetch fresh data using Company Profile Data for critical targets.

​
Use Cases

Search for companies by name and industry:
{
  "companyName": "Tech",
  "industry": ["Software Development"]
}
Find competitors in a specific industry and country:
{
  "industry": ["Software Development", "IT Services and IT Consulting"],
  "locationCountryCode": "US"
}
Target mid-sized companies with employee count filters:
{
  "employeeCountMin": 50,
  "employeeCountMax": 500
}
This example finds biotech companies with 50-500 employees. You can use either parameter alone or both together.
Find companies headquartered in a specific city and country:
{
  "locationCity": "San Francisco",
  "locationCountryCode": "US"
}
Discover all companies in one or more industries. Use an array for multiple industries:
{
  "industry": ["Software Development", "IT Services and IT Consulting"]
}
The complete list of available industries can be found in the Scrapin application.
The updateDate field indicates when the company was last refreshed in our database. For fresher data, use the Company Profile Data endpoint.

​
Best Practices

​
Efficient Searching

  • Be specific: Use multiple filters to narrow down results and improve relevance
  • Monitor costs: Each page costs 0.10 credits (20 results per page). Accessing multiple pages will consume additional credits.
  • Filter by freshness: Use the updateDate parameter to only retrieve companies updated within your required time frame (e.g., "updateDate": "30d" for last 30 days).

​
Hybrid Approach: Search + Live Enrichment

Maximize efficiency and accuracy with this workflow:
  1. Search - Use this endpoint with the updateDate parameter to find relevant companies with recent data
  2. Review - Check if the returned companies meet your freshness requirements
  3. Enrich - Use Company Profile Data only for companies that need even fresher data

​
Credit Consumption

Per Page

0.10 credits per page (maximum 20 results per page)
Cost-effective for finding multiple companies. Each page costs 0.10 credits regardless of the number of results (up to 20). Use pagination wisely to manage your credit consumption.

​
Request Tracking & Reporting

Found incorrect or missing data? Visit your API Logs to view all requests and report issues directly from the web interface.
How to report an issue:
  1. Go to app.scrapin.io/api-logs
  2. Find the request you want to report in the logs table
  3. Click the “Report” button in the Actions column
  4. Select the issue type and add a description
The request_id helps our team investigate and resolve issues quickly. All enrichment requests are automatically logged for your convenience.

Authorizations

​
apikey
string
query
required

This required parameter is a string. It represents the APIKEY obtained from the developer dashboard. You must use it in the query string of your request as ?apikey=YOUR_API_KEY or in the headers as x-api-key: YOUR_API_KEY

Body

application/json
​
companyName
string

Company name (starts with matching). Optional but at least one filter must be provided.

​
industry
string[]

Industry filter (array of industry names, e.g. ["Software Development", "IT Services and IT Consulting"]). The complete list of available industries can be found in the Scrapin application. Optional but at least one filter must be provided.

Example:
[
  "Software Development",
  "IT Services and IT Consulting"
]
​
employeeCountMin
integer

Minimum employee count. Use this to filter companies with at least this many employees.

Required range: x >= 0
Example:

50

​
employeeCountMax
integer

Maximum employee count. Use this to filter companies with at most this many employees.

Required range: x >= 0
Example:

500

​
locationCity
string

Headquarter city (starts with matching). Optional but at least one filter must be provided.

​
locationCountryCode
string

Country code(s), comma-separated (e.g., 'US,GB,FR'). Also accepts an array of strings. Optional but at least one filter must be provided.

Example:

"US,GB,FR"

​
updateDate
string

Optional parameter to filter by last update date. Only companies updated within this duration will be returned. Accepts duration strings like '4h', '2d', '1w', '2mo', '1y'. We use the parse-duration library internally to parse these values.

Example:

"30d"

​
page
integer
default:1

Page number for pagination (default: 1). Results are limited to 20 per page.

Response

The endpoint returns a list of companies matching the search criteria.

​
success
boolean

Indicates if the request was successful.

​
credits_consumed
number

Represents the number of credits consumed by this query.

​
credits_left
number

Represents the usable credits available for the user account after this query.

​
rate_limit_left
number

Represents the usable daily request limit available for the user account after this query.

​
daily_rate_limit_left
number

Represents the usable daily request limit available for the user account after this query.

​
minute_rate_limit_left
number

Represents the usable minute request limit available for the user account after this query.

​
next_minute_rate_limit_reset
string

Represents the next minute rate limit reset for the user account after this query. Datetime in ISO 8601 format (e.g., 2025-11-14T14:34:43.000Z).

​
quotas
object

Structured quota information for the user account. Provides the same data as the flat fields above in a more organized format.

​
metadata
object
​
pagination
object
​
companies
object[]

Array of company results.