Openmart

Access

Openmart is BYOK-only. Connect your own Openmart key in Integrations; calls run on your Openmart account and cost 0 Hyreflow credits. credit_balance verifies the connection and reads the remaining credits for that account. Connecting your own key needs the Essential plan or above.

Auth & config

• Base URL: https://api.openmart.ai · Auth: Authorization: Bearer (env OPENMART_API_KEY; never hardcode).

Pick the right starting point

• search_businesses returns store-level local-business records for location-specific prospecting.
• search_brands deduplicates physical locations into one company-level brand row for account lists and market sizing.
• search_business_ids is the lightweight search path when you need IDs, scores and cursors before full business details.
• enrich_company resolves a website or social profile to matching business records.

Search results can carry business identity, location, domain, phone, category, ownership, store-count, staff and social-link fields when Openmart has them. Use the last row's cursor to continue a store-level search.

Country coverage

Openmart lists 16 markets: United States, Canada, Australia, New Zealand, Puerto Rico, United Kingdom, Ireland, France, Spain, Germany, Austria, Belgium, Netherlands, Denmark, Luxembourg and Sweden. Expect little or no data elsewhere. A search in India returned nothing in testing, with no error.

Location field names

• search_businesses, search_business_ids and enrich_company take the postal code as zip_code.
• search_brands takes it as zipcode, with no underscore, and needs country on every location.
• In testing, search_businesses ignored a misspelled field (zipcode) without an error and searched the whole state, so test a new filter with a limit of 1 to 3 first.
• Search results return the postal code as content.zipcode.

Async people, email and technology jobs

Four methods start background batches:

• find_people discovers owners, decision-makers or other role-holders at known domains.
• lookup_people enriches people you already know by name and optional LinkedIn URL.
• lookup_business_email discovers shared company inboxes such as info@, support@ or sales@.
• find_tech checks known domains for a specified technology.

For each one, launch an array of task objects, keep the returned batch_id, poll get_batch_status until batch_ready is true, list completed IDs with get_batch_task_ids, then fetch each result with get_task_result. Add a tracking_id to each task when you need to join the result back to a source row.

Each task needs a bare root domain with no https://. find_people also needs title and max_k (1 to 8); lookup_people needs people (1 to 8 names); lookup_business_email needs company_name; find_tech needs tech_type. info_access takes EMAIL and PHONE in capitals, and lowercase email is rejected.

Email channel

Openmart's email methods are for BD and company outreach. Shared business mailboxes are not person records, and person-specific contacts are current-employer work contacts. Candidate outreach should use the personal_email waterfall and LinkedIn instead.

Recommended flow

Search stores or brands → qualify the local businesses against the ICP → optionally detect technology → find the owner or decision-maker → retrieve work contact details → verify → sequence or push to the CRM.

Callable surface

Call via the CLI: hyreflow tools execute openmart <method> --payload '{...}' (preview with --dry-run; hyreflow tools get openmart <method> returns the live contract + cost). Base: https://api.openmart.ai. Only the methods listed below are callable.

• credit_balance() -> Any — GET /api/v2/credit-balance — read the authenticated team's remaining credits.
• enrich_company(payload: dict) -> Any — POST /api/v1/enrich_company — match business records from a website or social URL.
  • example: {"website":"https://acme.example.com","location":[{"country":"US","state":"CA"}],"limit":2}
• find_people(tasks: list[dict]) -> Any — POST /api/v1/task/batch/find_people — start 1–100 decision-maker tasks.
• find_tech(tasks: list[dict]) -> Any — POST /api/v1/task/batch/find_tech — start technology-detection tasks.
• get_batch_status(batch_id: str) -> Any — GET /api/v1/task/batch/{batch_id}/status — poll a submitted batch.
• get_batch_task_ids(batch_id: str, *, status: str | None = None) -> Any — GET /api/v1/task/batch/{batch_id}/task_ids — list task IDs, optionally by status.
• get_task_result(task_id: str) -> Any — GET /api/v1/task/{task_id} — retrieve one completed background-task result.
• lookup_business_email(tasks: list[dict]) -> Any — POST /api/v1/task/batch/lookup_business_email — start 1–100 mailbox lookups.
• lookup_people(tasks: list[dict]) -> Any — POST /api/v1/task/batch/lookup_people — enrich 1–100 known-person tasks.
• search_brands(payload: dict) -> Any — POST /api/v2/brands/search — deduplicated brand/company search.
  • example: {"search_param":{"search_term":"coffee","location":[{"country":"US","state":"TX","zipcode":["78701"]}],"ownership_type":["INDEPENDENT"]},"pagination":{"limit":20}}
• search_business_ids(payload: dict) -> Any — POST /api/v1/search/only_ids — lightweight search using the full-search request body.
  • example: {"query":"coffee shop","location":[{"country":"US","state":"TX","city":"Austin","zip_code":["78701"]}],"has_valid_website":true,"limit":25}
• search_businesses(payload: dict) -> Any — POST /api/v1/search — full local-business search (limit 1–1000).
  • example: {"query":"coffee shop","location":[{"country":"US","state":"TX","city":"Austin","zip_code":["78701"]}],"has_valid_website":true,"limit":25}