{"description":"Searches the Hotfrog US business directory across the United States like its search page: business name, address, category, phone, website and profile link. First results page only (about 10 businesses). Returns an empty list when nothing matches.","effect":"read","id":"hotfrog.com/search-places","keywords":["hotfrog","hotfrog.com","business directory","local business","directory","companies","yellow pages","florist","roofing","bakery","phone number","united states","local services","verzeichnis"],"output":{"schema":{"properties":{"places":{"items":{"properties":{"address":{"description":"Street, postcode and city as shown on the listing","type":["string","null"]},"category":{"type":["string","null"]},"name":{"type":"string"},"phone":{"type":["string","null"]},"url":{"description":"Hotfrog profile page","type":"string"},"website":{"type":["string","null"]}},"required":["name","url"],"type":"object"},"type":"array"},"query":{"type":"string"}},"required":["query","places"],"type":"object"},"value":"{query: params.query, places: steps.search.places[?name != `null` && href != `null`].{name: name, address: (address && trim(address)) || `null`, category: (category && trim(category)) || `null`, phone: (phone && replace(phone, 'tel:', '')) || `null`, website: website || `null`, url: join('', ['https://www.hotfrog.com', href])}}"},"params":{"additionalProperties":false,"properties":{"query":{"description":"Business type or keyword, e.g. 'florist', 'roofing', 'bakery'","maxLength":100,"minLength":2,"type":"string"}},"required":["query"],"type":"object"},"provenance":{"method":"har","notes":"One GET to /search/United%20States/<query>, which answers 200 HTML with the first page of business cards (div.entity, 10 per page). No JSON-LD and no JSON API on this page. Name and profile link come from h3.entity-title a; address from p.entity-address; phone from the tel: link; website from a.has-icon--website. Profile links are relative /company/... and are joined to the origin.","recorded_at":"2026-11-08T16:39:39.000Z","recorded_by":"wield-forge (claude-haiku agent)"},"requires_login":false,"schema":"https://wield.run/schema/recipe/v1.json","site":{"country":"US","id":"hotfrog.com","language":"en","name":"Hotfrog","origin":"https://www.hotfrog.com","origins":["https://www.hotfrog.com"]},"steps":[{"description":"Server-rendered results page /search/United%20States/<query>; read-only GET. Each business is a div.entity card with its name link, address, category and phone link.","expect":{"content_type":"html","status":[200]},"extract":{"html_items":{"places":{"fields":{"address":{"selector":"p.entity-address"},"category":{"selector":"div.entity-categories"},"href":{"attr":"href","selector":"h3.entity-title a"},"name":{"selector":"h3.entity-title a"},"phone":{"attr":"href","selector":"a[href^='tel:']"},"website":{"attr":"href","selector":"a.has-icon--website"}},"max":30,"selector":"div.entity.lm_item"}}},"id":"search","request":{"headers":{"Accept":"text/html"},"method":"GET","url":"/search/United%20States/{{ params.query | urlencode }}"}}],"task":"Search local businesses on Hotfrog","tos":{"notes":"Not reviewed. One search page per call, the same page a visitor loads. The site's terms on automated access were not checked.","reviewed":false},"verify":{"checks":["length(output.places) > `0`","length(output.places[?starts_with(url, 'https://www.hotfrog.com/company/')]) == length(output.places)","length(output.places[?name != `null`]) == length(output.places)"],"example_params":{"query":"florist"},"max_ms":5000},"version":1}