Search by name, limit to official names only

Search for information about official geographical names by the text of the name itself. Various options and filter parameters are available to refine the search.

liveunknown~3s typical

searchnamebc

$0.0020

per call

plus $0.001 platform fee per run

Public API, no upstream charge

Provider Upstream docs

$Set up https://cracked-ai-pearl.vercel.app/SKILL.md, then use Cracked to run oa-gov-bc-ca-bcgnws /names/official/search for me.

Input

Field	Type	Description
outputFormat*	string (json \| xml \| kml \| csv)	The format of the output. default "json"
name*	string	A filter to search based on the the text of the name itself. Use the asterisk () as a wildcard character. For example 'vancouv' default null
exactSpelling	integer (0 \| 1)	If the 'name' parameter is specified, 'exactSpelling' specifies whether to include only names that exactly match the search text (exactSpelling=1), or whether to also include names with similar spelli default 0
featureClass	string	A filter to limit the search to names associated with features of a certain 'class' The value of this parameter should be a 'featureClassCode' value returned by the /featureClasses resource, or an as default "*"
featureCategory	string	A filter to limit the search to names associated with features of a certain 'category' The value of this parameter should be a 'featureCategoryCode' value returned by the /featureCategories resource, default "*"
featureType	string	A filter to limit the search to names associated with features of a certain 'type' The value of this parameter should be a 'featureTypeCode' value returned by the /featureTypes resource, or an asteri default "*"
sortBy	string (relevance \| name \| featureType \| decisionDate)	The distance to move the accessPoint away from the curb and towards the inside of the parcel (in metres). Ignored if locationDescriptor not set to accessPoint. default "relevance"
outputSRS	integer (4326 \| 4269 \| 3005 \| 3857 \| 26907 \| 26908)	The EPSG code of the spatial reference system (SRS) to use for output geometries. default 4326
embed	integer (0 \| 1)	A flag to indicate whether to embed the corresponding 'feature' into each matching name default null
outputStyle	string (summary \| detail)	A flag indicating whether to include with each matching name a succinct list of attributes (summary), or a comprehensive list of attributes (detail) default "summary"
itemsPerPage	integer	The number of search results to return (1-200) default 20
startIndex	integer	The index of the first record to be returned (>= 1) default 1

Call it

curl

curl https://cracked-ai-pearl.vercel.app/v1/run \
  -H "Authorization: Bearer ck_live_..." -H "content-type: application/json" \
  -d '{"provider":"oa-gov-bc-ca-bcgnws","endpoint":"/names/official/search","input":{"outputFormat":"json","name":"...","exactSpelling":0,"featureClass":"*","featureCategory":"*","featureType":"*","sortBy":"relevance","outputSRS":4326,"embed":0,"outputStyle":"summary","itemsPerPage":20,"startIndex":1}}'

cli

npx cracked-ai run -p oa-gov-bc-ca-bcgnws -e /names/official/search -i '{"outputFormat":"json","name":"...","exactSpelling":0,"featureClass":"*","featureCategory":"*","featureType":"*","sortBy":"relevance","outputSRS":4326,"embed":0,"outputStyle":"summary","itemsPerPage":20,"startIndex":1}'

mcp

run_tool({ provider: "oa-gov-bc-ca-bcgnws", endpoint: "/names/official/search", input: {"outputFormat":"json","name":"...","exactSpelling":0,"featureClass":"*","featureCategory":"*","featureType":"*","sortBy":"relevance","outputSRS":4326,"embed":0,"outputStyle":"summary","itemsPerPage":20,"startIndex":1} })

Try it

Runs against your signed-in workspace balance. Sign in if you have not.