Business Lookup API: name and city in, full listing out
Turn a business name and city into a complete record: address, phone, website, category, star rating, review count and hours from live business-listing data. 10 credits, only charged on a match.
10
Credits per match
~$0.035-0.05 per business
0
Credits on a miss
no listing, no charge
1-3 min
First live fetch
listing pulled fresh
Instant
Repeats for 7 days
served from cache
What Business Lookup gives you
The whole listing in one call
Address, phone, website, category, star rating, review count, opening hours, open-or-closed status and a stable place_id: everything the listing publishes, returned as one structured record.
- Address, phone and website
- Rating and review count
- Opening hours and open/closed
- Stable place_id to store
Live at lookup time
Each first lookup is a live deep fetch of the listing, not a read from a database that went stale months ago. If the business closed last quarter, you see closed before a rep wastes a dial on it.
- Fetched live, in seconds
- Current open/closed status
- Repeat lookups instant for 7 days
- No stale-database surprises
Only charged on a match
If the name and city do not resolve to a listing, you pay nothing. That makes it safe to run raw lists where a real share of the rows were always going to miss.
- Zero credits on no match
- Applies to bulk jobs too
- Predictable cost on messy lists
- No minimum commitment
About a nickel per business
10 credits per matched listing works out to roughly $0.05 on the Starter plan and $0.035 on Growth. Filling in phone, website and address on a 1,000-row list of names costs about $35-50, and only the rows that match bill at all.
- 10 credits per match
- ~$0.035 per business on Growth
- ~$0.05 per business on Starter
- Misses are free
Built to feed Phone Validation
The lookup hands you the listing's number; Phone Validation (1 credit) then confirms the line is active, tells you mobile versus fixed-line, and checks do-not-call status. Together they turn a business name into a number a rep can legally and usefully dial.
- Listing phone on every match
- Chain into line-type checks
- Do-not-call screening next
- 11 credits for the full chain
Same credits, same API
One balance covers Business Lookup, phone, email and every other 1Lookup product. Same authentication, same response envelope, and bulk CSV support out of the box.
- Universal credits
- Credits roll over
- One API key
- Bulk CSV supported
Name and city in, listing out
Send a name and city
POST business_name and city; country defaults to US. Already have the listing's URL? Pass place_url and skip the match entirely.
$ POST /v1/business-lookup
"business_name": "Riverside Roofing"
"city": "Austin"
> country defaults to US
We fetch the listing live
First lookups run a live deep fetch of the listing, typically one to three minutes. Repeats on the same business within 7 days return instantly from cache.
Name and city matched
Live listing located
Hours, rating, reviews read
Building record, 1-3 min fresh
Get one structured record
Address, phone, website, rating, hours and status land in one JSON payload. A match bills 10 credits; a miss bills nothing.
businessRiverside Roofing
phone+15125550193
rating4.8 (167 reviews)
One endpoint. A business name and city in, structured data out.
Same authentication, same credit balance, and the same response envelope as every other 1Lookup product. If you have already integrated one endpoint, this one is a URL change.
curl -X POST https://app.1lookup.io/api/v1/business-lookup \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"business_name": "Riverside Roofing",
"city": "Austin"
}'{
"classification": {
"matched": true,
"business_name": "Riverside Roofing",
"address": "2108 S Lamar Blvd, Austin, TX 78704",
"phone": "+15125550193",
"category": "Roofing contractor",
"rating": 4.8,
"review_count": 167,
"listing_status": "operational",
"place_id": "ChIJd3M9a7m1RIYRlbQzRg2wQ2E"
},
"insights": {
"business_lookup_result": {
"website": "https://riversideroofingatx.com",
"hours": {
"monday": "8:00 AM - 6:00 PM",
"tuesday": "8:00 AM - 6:00 PM",
"saturday": "9:00 AM - 1:00 PM",
"sunday": "Closed"
},
"is_claimed": true,
"country": "US"
}
},
"metadata": { "credits_used": 10, "cache_hit": false }
}What a matched listing looks like
One call turns a name on a list into a record you can dial, visit or write straight into a CRM row: contact details, reputation, hours and current status, side by side with the raw JSON your code receives.
- BusinessRiverside Roofing
- CategoryRoofing contractor
- Address2108 S Lamar Blvd, Austin, TX 78704
- Phone+15125550193
- Websiteriversideroofingatx.com
- Rating4.8 stars, 167 reviews
- StatusOperational
- Claimed listingYes
- Monday8:00 AM - 6:00 PM
- Saturday9:00 AM - 1:00 PM
- SundayClosed
{
"classification": {
"matched": true,
"business_name": "Riverside Roofing",
"address": "2108 S Lamar Blvd, Austin, TX 78704",
"phone": "+15125550193",
"category": "Roofing contractor",
"rating": 4.8,
"review_count": 167,
"listing_status": "operational"
},
"insights": {
"business_lookup_result": {
"website": "https://riversideroofingatx.com",
"hours": {
"monday": "8:00 AM - 6:00 PM",
"saturday": "9:00 AM - 1:00 PM",
"sunday": "Closed"
},
"is_claimed": true
}
},
"metadata": { "credits_used": 10 }
}Every field you get back
No hidden tiers. Every field below is returned on a successful lookup at the price shown above.
Identity
- business_name
- category
- place_id
Contact
- address
- phone
- website
Reputation
- rating
- review_count
Hours & status
- hours
- is_claimed
- listing_status
Who uses Business Lookup
Local lead-gen agencies
A client hands over a list of business names pulled from a directory or a niche association roster. One pass fills in phone, website, address and rating for every name that resolves, and the names that do not resolve cost nothing.
Skip tracers
A business name surfaces in a filing or a debtor record with no usable contact details. Name plus city returns the current address and phone, plus whether the business is even still operating.
Sales ops refreshing a CRM
Account records rot: numbers change, businesses move or close. Run the account list through before a calling block so reps dial current numbers and closed businesses drop out instead of burning dials.
Agencies prospecting by reputation
Rating and review count come back on every match, so a reputation-management or ads agency can sort a market's businesses by review footprint and pitch the ones that actually need the help.
Frequently asked questions
What does Business Lookup return?
Give it a business name and a city and it returns the full listing: street address, phone number, website, business category, star rating, review count, opening hours, whether the business is currently open, and a stable place_id you can store. It is one call that turns a name on a list into a record you can actually contact.
What inputs do I need?
business_name and city are required, and country defaults to US. If you already have the listing's URL you can pass place_url instead and skip the name-and-city match entirely.
Am I charged when no business is found?
No. Business Lookup is success-billed: if we cannot match the name and city to a listing, zero credits are deducted. The 10-credit price applies only when a listing comes back, and the same rule applies to API calls, the dashboard and bulk CSV jobs.
How long does a lookup take?
A first-time lookup runs a live deep fetch of the business listing, so expect it to take on the order of a minute, typically one to three minutes and occasionally longer, rather than the sub-second responses of our phone and email products. Repeat lookups on the same business within 7 days are served from cache and return instantly.
What does it cost in dollars?
10 credits per matched business: about $0.05 on the Starter plan and $0.035 on Growth. No-match lookups cost nothing, so a list where half the names never resolve only bills for the half that does.
How is this different from Business Verify?
Business Lookup (10 credits) returns the raw listing facts: address, phone, website, hours, rating. Business Verify (30 credits) runs the listing plus any phone, email or website you supply through validation and hands back a 0-100 score and a verdict. Use Lookup when you want data; use Verify when you need a real-or-not decision.
Is the phone number on the listing safe to dial?
The listing gives you the number a business publishes; it does not tell you the line type or do-not-call status. Most calling teams chain the two: Business Lookup to get the number, then Phone Validation (1 credit) to confirm it is active, see whether it is mobile or fixed-line, and check do-not-call registries before a rep dials.
Can I look up a whole list at once?
Yes. Upload a CSV with a business_name column (plus city) and the bulk pipeline resolves every row. Rows where no listing is found cost nothing, so a messy or half-guessed list does not inflate the bill.