search_businesses - Surfing Dog Search

Find businesses in the directory by what they do (query, category: a group or a place category), where (near, country), the language they speak, whether they are open now, their attributes (list_attributes), price band, what their doors take and what they accept (accepts), whether a door answers asks or quotes (requestable), the type of door, their readiness level, whether they have an inbox, and whether they are members, registered or found. Results come in the directory's published order, which nobody can pay to change; every filter only leaves businesses out. This server takes no bookings or orders; each result lists the business's own doors. A business this network found on its own website is marked as found, with the date it was checked. Software, API and AI companies (category software-ai) are kept apart: they come only when category names that group or one of its categories, query names their kind, or every word of query is in one's name. Pages of up to 20; pass next_cursor as cursor for more.

Name	Required	Description
`near`	No	Only businesses within radius_km of this point, each with its distance.
`level`	No	At this readiness level or above: askable (an AI can ask), bookable or orderable, payable. Nothing below askable is listed yet. This only leaves businesses out.
`limit`	No	How many to return: 10 when left out.
`order`	No	rank: the published order (the default); nearest: by distance, and it needs near.
`query`	No	A few words about what the business does or where, like "florist" or "coffee singapore". Every word must match its name, town, description, categories, tags or services, ignoring capitals and accents. Words like "open" or "near me" belong in open_now and near instead.
`cursor`	No	next_cursor from the previous answer, for the next page of the same search.
`source`	No	member (through its inbox), registered (by the business), found (by this network on the business's own website); any of them. This only leaves businesses out.
`accepts`	No	What its live doors take and what it accepts as payment, all of them: ask, quote, book, order, pay, or a payment from list_attributes like card or pix. This only leaves businesses out.
`country`	No	A country code like PT or BR: a business located there, serving it or shipping there. This only leaves businesses out.
`category`	No	A slug from list_categories, like hair-beauty, or a place category id like hair_salon, with every category below it. Its label or a synonym works too. Under rules before version 7 any other word matches the tags businesses gave themselves; from version 7 it is an error that names up to 5 categories to try.
`language`	No	Only businesses that speak this language, as a tag like pt or en; pt also finds pt-br.
`open_now`	No	true: only businesses open right now by the hours they published. One that published no hours is left out.
`door_type`	No	A live door of any of these types: inbox, mcp, a2a, openapi, api, ucp, acp, nlweb, other, "platform" for any platform, or platform:<name>. This only leaves businesses out.
`has_inbox`	No	true: with an inbox door; false: without one. This only leaves businesses out.
`item_type`	No	Only businesses whose inbox takes this.
`attributes`	No	Keys from list_attributes, like "delivery" or "walk_ins", or key=value for one with values; every one must hold. This only leaves businesses out.
`price_band`	No	1 (cheapest) to 4, as "2" or a range "1-2". This only leaves businesses out.
`requestable`	No	A live door that declared it answers this kind. This only leaves businesses out.

Name

Required

Description

Default

near

Only businesses within radius_km of this point, each with its distance.

level

At this readiness level or above: askable (an AI can ask), bookable or orderable, payable. Nothing below askable is listed yet. This only leaves businesses out.

limit

How many to return: 10 when left out.

order

rank: the published order (the default); nearest: by distance, and it needs near.

query

A few words about what the business does or where, like "florist" or "coffee singapore". Every word must match its name, town, description, categories, tags or services, ignoring capitals and accents. Words like "open" or "near me" belong in open_now and near instead.

cursor

next_cursor from the previous answer, for the next page of the same search.

source

member (through its inbox), registered (by the business), found (by this network on the business's own website); any of them. This only leaves businesses out.

accepts

What its live doors take and what it accepts as payment, all of them: ask, quote, book, order, pay, or a payment from list_attributes like card or pix. This only leaves businesses out.

country

A country code like PT or BR: a business located there, serving it or shipping there. This only leaves businesses out.

category

A slug from list_categories, like hair-beauty, or a place category id like hair_salon, with every category below it. Its label or a synonym works too. Under rules before version 7 any other word matches the tags businesses gave themselves; from version 7 it is an error that names up to 5 categories to try.

language

Only businesses that speak this language, as a tag like pt or en; pt also finds pt-br.

open_now

true: only businesses open right now by the hours they published. One that published no hours is left out.

door_type

A live door of any of these types: inbox, mcp, a2a, openapi, api, ucp, acp, nlweb, other, "platform" for any platform, or platform:<name>. This only leaves businesses out.

has_inbox

true: with an inbox door; false: without one. This only leaves businesses out.

item_type

Only businesses whose inbox takes this.

attributes

Keys from list_attributes, like "delivery" or "walk_ins", or key=value for one with values; every one must hold. This only leaves businesses out.

price_band

1 (cheapest) to 4, as "2" or a range "1-2". This only leaves businesses out.

requestable

A live door that declared it answers this kind. This only leaves businesses out.

Name	Required	Description
`rules`	Yes	The rules that ordered these businesses (GET /v1/ranking?version=N).
`businesses`	Yes	In the directory's published order: no one can pay to move in it.
`next_cursor`	Yes	Pass it as cursor for the next page; null on the last.

Name

Required

Description

Default

rules

Yes

The rules that ordered these businesses (GET /v1/ranking?version=N).

businesses

Yes

In the directory's published order: no one can pay to move in it.

next_cursor

Yes

Pass it as cursor for the next page; null on the last.

Surfing Dog Search

Find businesses

Input Schema

Output Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources