Openmart: Search Businesses

Find local business/store records by keyword, category, quality filters, and location.

Tool ID: openmart_search_businesses

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'openmart_search_businesses',
  {
    "query": "software companies hiring engineers",
    "limit": 100,
    "location": [
      {
        "country": "US",
        "state": "California",
        "city": "San Francisco"
      }
    ]
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run openmart_search_businesses --input '{
  "query": "software companies hiring engineers",
  "limit": 100,
  "location": [
    {
      "country": "US",
      "state": "California",
      "city": "San Francisco"
    }
  ]
}'

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": [
    {
      "id": "id_123",
      "content": {
        "contacts_locked": true,
        "has_business_phone": true,
        "has_business_email": true
      },
      "match_score": 123
    }
  ]
}

Use deepline describe openmart_search_businesses --json for the latest machine-readable contract.

Input reference

Search Openmart local business records by keyword, location, quality filters, and business attributes. Contact fields come back locked: each row has content.contacts_locked true and empty business_phones, store_phones, business_emails, and store_emails arrays. Every row is billed: rows with contacts locked at a lower per-record rate, rows with contacts unlocked at a higher rate. For company emails, pass content.root_domain and content.business_name to openmart_lookup_business_email (billed per email found). For named decision makers with emails or phones, use openmart_find_people. Openmart’s company or store phone lookup is not available as a Deepline tool.

Name	Type	Required	Default	Details
`payload.query`	`string`	No	—	Minimum length: 1. Maximum length: 500.
`payload.limit`	`integer`	No	`100`	Minimum: 1. Maximum: 1000.
`payload.location`	`array`	No	—	—
`payload.has_website`	`boolean`	No	—	—
`payload.has_valid_website`	`boolean`	No	—	—
`payload.has_contact_info`	`boolean`	No	—	Only return businesses that Openmart indexes as having contact information. This filters on availability. The contact values themselves are still locked in search results.
`payload.tags`	`array`	No	—	Maximum items: 100.
`payload.store_name`	`string`	No	—	—
`payload.min_locations`	`integer`	No	—	—
`payload.max_locations`	`integer`	No	—	—
`payload.min_overall_rating`	`number`	No	—	Minimum: 0. Maximum: 5.
`payload.max_overall_rating`	`number`	No	—	Minimum: 0. Maximum: 5.
`payload.min_total_reviews`	`integer`	No	—	—
`payload.max_total_reviews`	`integer`	No	—	—
`payload.min_price_tier`	`integer`	No	—	—
`payload.max_price_tier`	`integer`	No	—	—
`payload.ownership_type`	`string`	No	—	—
`payload.include_keywords`	`array`	No	—	Maximum items: 64.
`payload.exclude_keywords`	`array`	No	—	Maximum items: 64.
`payload.exclude_root_domains`	`array`	No	—	—
`payload.open_date_after`	`string`	No	—	—
`payload.open_date_before`	`string`	No	—	—
`payload.info_updated_after`	`string`	No	—	—
`payload.info_updated_before`	`string`	No	—	—
`payload.cursor`	`array`	No	—	—
`payload.estimate_total`	`boolean`	No	—	—

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`array \| object`	Yes	—	Provider response payload.
`result.data.data`	`array`	Yes	—	—
`result.data.data[].id`	`string`	No	—	—
`result.data.data[].content`	`object`	No	—	—
`result.data.data[].content.contacts_locked`	`boolean`	No	—	True when Openmart withholds the contact values on this row. business_phones, store_phones, business_emails, and store_emails are then empty even if has_business_phone or has_business_email is true.
`result.data.data[].content.has_business_phone`	`boolean`	No	—	Openmart has a business phone in inventory. Does not mean a phone is returned in this row.
`result.data.data[].content.has_business_email`	`boolean`	No	—	Openmart has a business email in inventory. Does not mean an email is returned in this row.
`result.data.data[].match_score`	`number`	No	—	—
`result.data.data[].match_highlights`	`array`	No	—	—
`result.data.data[].cursor`	`array`	No	—	—
`result.data.total_count`	`integer`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.13 per pricing unit.

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation