Using the Openmart API to fetch data

Whether you’re building internal tools or powering outreach automation, the Openmart API gives you real-time access to enriched business and people data — fast, flexible, and developer-friendly.

Let’s walk through how to generate your token, pull data, and run batch enrichment.

‍

Why use the Openmart API

‍

Let’s be honest: most data APIs don’t give you control, transparency, or clean data.

At OpenMart, we’ve made it easy for devs and ops teams to:

• Pull clean, filtered business data in seconds
• Enrich people-level info at scale
• Track usage and credit consumption in real time

‍

‍

What makes our data different

‍

Our engine combines multiple signals into one clean dataset:

‍

• Verified business profiles across Google, Yelp, and Meta
• Fresh ownership & contact data
• Review-based quality filters
• Location, category, and keyword-based targeting
• Activity and website presence signals

‍

No more outdated listings or generic leads.

‍

‍

How to generate and monitor your API token (Step-by-step)

‍

Step 1: Go to your Openmart dashboard and click "API management"

‍

‍

‍

Step 2: Click "Copy" or "Create new token"

‍

‍

‍

Step 3: Monitor your usage

‍

‍

‍

‍

How to use the /search endpoint (Step-by-step)

Use this endpoint when you want to find real, live business leads by keyword or category — like “plumbers in Brooklyn” or “med spas in Los Angeles.”

‍

Endpoint‍

POST https://api.openmart.ai/api/v1/search

‍

Step 1: Prepare your cURL request

curl --location --request POST 'https://api.openmart.ai/api/v1/search' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
 "estimate_total": true,
 "query": "Western Australia pride tours",
 "pagination": {
   "limit": 50,
   "start": 0,
   "total_count": {
     "max_num": 150000,
     "to_estimate": false
   }
 },
 "info_updated_before": 1741621734
}'

‍

Modify your search terms

• Change "query" to your desired keyword (e.g., "hair salons in Queens")
• Adjust "limit" to control how many results you want (max = 100 per request)
• "start" controls pagination (e.g., use 0 for first page, 100 for second)
• Add "info_updated_before" to limit to recently updated businesses. (Optional)

‍

Step 2: Hit enter and get results

‍

‍

How to use the batch people lookup endpoint (Step-by-step)

Use this when you want to enrich specific people by name and company/domain — like “CEO of xyzcompany.com.”

‍

Step 1: Submit a POST request with people + company data

‍

Use this sample structure:

curl --location --request POST 'https://api.openmart.ai/api/v1/task/batch/lookup_people' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '[
 {
   "domain": "http://openmart.com/",
   "info_access": ["PHONE", "EMAIL"],
   "state": "CA",
   "title": "ceo",
   "people": [
     {
       "first_name": "Richard",
       "last_name": "He"
     }
   ]
 }
]'

‍

Modify inputs for your task

‍

• Replace domain with the company’s site
• Replace title and name fields accordingly
• Add multiple people/companies in one batch

‍

Step 2: Get response of batch ID

{
 "batch_id": "YOUE_BATCH_ID",
 "status": {
   "completed": 0,
   "processing": 1,
   "batch_ready": false
 }
}

‍

Save the batch_id — you’ll need it to check the task status.

‍

‍

How to monitor batch status

‍

Endpoint

GET https://api.openmart.ai/api/v1/task/batch/{batch_id}/status

‍

Step 1: Replace {batch_id} in the URL with your real batch ID.

‍

Step 2: Run this in your terminal:

curl --location --request GET 'https://api.openmart.ai/api/v1/task/batch/95b4e211-788d-4104-a484-ea6e82da23eb/status' \
--header 'x-api-key: YOUR_API_KEY'

‍

Step 3: Check status fields:

• completed: number of results available
• processing: tasks still in queue
• batch_ready: true when everything’s done

‍

‍

What this API means for you

‍

• 🗑 Say goodbye to manual scraping
• ⚙️ Automate your enrichment flow
• 🎯 Reach better-fit leads faster
• 📈 Power internal tools with reliable, filtered data

‍

‍

Ready to build smarter?

If you’re already on OpenMart, just generate your API token and start testing today.

If you’re new, reach out for a demo — we’d love to show you how it works

‍