LifestylePlatform secret

Gurunavi

api.gnavi.co.jp

Gurunavi restaurant search provider for Japanese dining listings.

Tier: 🥉 Bronze
Reward: ₩50,000
Auth: Platform secret
Operations: 3
Working now: 0 contributors
Status: Open

Scope

Uses the official Gurunavi RestSearchAPI v3 endpoint to search restaurants by keyword, area, prefecture, or coordinates. The hunter must handle API-key authentication and map the response from the `rest` array into structured restaurant records.

Expected operations

search-restaurants-by-keywordSearch restaurants by keywordreadDifficulty: easy

Search Japanese restaurants by free-text keyword and return normalized restaurant listings from the result set. Backed by Gurunavi restaurant search.

Inputs

keyidstringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

keywordstringoptional

Free-text search term

ramen

hit_per_pagenumberoptional

Number of results per page

pagenumberoptional

Page number to fetch

Outputs

restnameaddressbudgetcodelatitudelongitude

Acceptance

Returns a `rest` array with restaurant names and addresses for a keyword query.
Includes at least `name`, `address`, and `budget` for matched entries.
Handles paging without losing the original query context.

Auth required for this operation.

search-restaurants-by-areaSearch restaurants by area and prefecturereadDifficulty: easy

Search Japanese restaurants within a requested prefecture or area and return normalized location-aware listings. Backed by Gurunavi restaurant search.

Inputs

keyidstringrequired
Gurunavi API key
abc123
prefstringoptional
Prefecture code or name filter
PREF13
areastringoptional
Area code filter
AREA01
rangenumberoptional
Search radius bucket used by the API
3

Outputs

restnameprefnameareanameaddresslatitude

search-restaurants-by-locationSearch restaurants by coordinatesreadDifficulty: medium

Find nearby restaurants around a coordinate pair and return normalized geospatial restaurant listings. Backed by Gurunavi restaurant search.

Inputs

keyidstringrequired
Gurunavi API key
abc123
latitudenumberrequired
Search center latitude
35.681236
longitudenumberrequired
Search center longitude
139.767125
rangenumberoptional
Search radius bucket
2

Outputs

restnameaddresslatitudelongitudeurl

Acceptance

Returns restaurants constrained by the requested prefecture or area code.
Shows location fields that let a caller distinguish prefecture and area matches.
Does not fall back to a global result set when filters are supplied.

Auth required for this operation.

Acceptance

Returns nearby restaurant results for the supplied coordinate pair.
Preserves the geospatial fields needed to plot each restaurant on a map.
Accepts a radius setting and changes the result set accordingly.

Auth required for this operation.