Company Search

post

https://api.marketcircle.net/v1/companies/_search

Search for companies

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

See the search filtering documentation for details about the query syntax. The searchable attributes and the operators each one accepts are listed in the request body below.

Company-specific notes

Email addresses are searched with the key email_addresses, not emails:
{ "email_addresses": { "any": { "address": { "ends_with": "@example.com" } } } }
Phone numbers compare digits only, so "905-555-0100" and "9055550100" match the same number.
category, type, industry and region match by name, e.g. { "industry": { "equal": "Software" } }.
Contacts, opportunities and projects take a search filter for that record type with any, so you can match by reference or by any of its attributes:
{ "contacts": { "any": { "contact": { "equal": "/v1/contacts/1000" } } } }
{ "contacts": { "any": { "last_name": { "equal": "Smith" } } } }
Linked records (appointments, notes, tasks, groups, forms, email_messages) work the same way, using the linked record's reference:
{ "notes": { "any": { "note": { "equal": "/v1/notes/1000" } } } }
role matches the name of a role the company has with a contact, opportunity or project, e.g. { "role": { "equal": "Customer" } }.
image can only be searched with blank and not_blank. As with all attributes, the value given to blank and not_blank is ignored.
company and company_id match the company itself, by reference or by numeric ID.
Numbers must be sent as JSON numbers, e.g. { "number_of_employees": { "greater_than": 50 } }, not "50".

Related companies (the companies list on a company) can't be searched; use relationship search instead.

Query Params

limit

int32

≤ 250

Defaults to 50

Maximum number of results per page (max 250). Defaults to 50, or 10 when full-records is true.

full-records

boolean

Return every attribute of each result instead of the short list form.

start

int32

Return results whose ID is greater than or equal to this value. Use the next URL from the previous page rather than building this yourself.

Body Params

name

object

Example: Marketcircle Inc.

tagline

object

Tagline

ticker_symbol

object

Example: AAPL

sic_code

object

SIC code

number_of_employees

object

Example: {"greater_than": 50}

flagged

object

Example: true

image

object

Whether the company has an image

category

object

Category name, e.g. Client

keywords

object

Keyword names, e.g. {"any": ["Partner", "Supplier"]}

type

object

Company type name, e.g. Corporation

industry

object

Industry name, e.g. Software

region

object

Region name, e.g. North America

extra_fields

object

Filter on extra (custom) fields. Each operator takes an object keyed by the field's default identifier (even if it has been renamed), e.g. {"equal": {"com.marketcircle.daylite/extra1": {"value": "Gold"}}}. Several operators can be combined. Text operators (starts_with, contains, …) only work on text fields and range operators (less_than, greater_than, …) only on date fields.

email_addresses

object

Email addresses. Note the key is email_addresses, not emails. Example: {"any": {"address": {"ends_with": "@example.com"}}}

urls

object

Websites. Example: {"any": {"url": {"contains": "example.com"}}}

social_profiles

object

Social profiles. Example: {"any": {"service": {"equal": "LinkedIn"}}}

phone_numbers

object

Phone numbers. Example: {"any": {"number": {"starts_with": "1905"}}}

addresses

object

Postal addresses. Example: {"any": {"city": {"equal": "Markham"}}}

contacts

object

People with a role at the company. The operand is a contact search filter, e.g. {"any": {"contact": {"equal": "/v1/contacts/1000"}}}.

opportunities

object

Opportunities the company has a role on. The operand is an opportunity search filter.

projects

object

Projects the company has a role on. The operand is a project search filter.

role

object

Name of a role the company has with a contact, opportunity or project, e.g. Customer

appointments

object

Records linked to appointments. The operand is a search filter on appointments, for example {"any": {"appointment": {"equal": "/v1/appointments/1000"}}}.

notes

object

Records linked to notes. The operand is a search filter on notes, for example {"any": {"note": {"equal": "/v1/notes/1000"}}}.

tasks

object

Records linked to tasks. The operand is a search filter on tasks, for example {"any": {"task": {"equal": "/v1/tasks/1000"}}}.

groups

object

Records linked to groups. The operand is a search filter on groups, for example {"any": {"group": {"equal": "/v1/groups/1000"}}}.

forms

object

Records linked to forms. The operand is a search filter on forms, for example {"any": {"form": {"equal": "/v1/forms/1000"}}}.

email_messages

object

Records linked to emails. The operand is a search filter on emails, for example {"any": {"email_message": {"equal": "/v1/emails/1000"}}}.

company

object

The company itself, by reference, e.g. /v1/companies/1000

company_id

object

The company's numeric ID

owner

object

Owner reference, e.g. /v1/users/1000

creator

object

Creator reference, e.g. /v1/users/1000

create_date

object

Example: 2025-03-04T17:45:57.550Z

modify_date

object

Example: 2025-03-04T17:45:57.550Z

Responses

Company-specific notes

200200 OK

400400 Bad Request