Place Search

For AI agents: docs.octen.ai/capabilities/place-search.md

Finding a place to go means checking a map for what is nearby, a website for the opening hours, and local food guides for what is worth trying. A model working from web pages has to read all of them, and spend tokens on every one. Octen Place Search returns the places that match the query as place cards, with the address, coordinates, contact details, opening status, and rating already in fields. Pass the location of the request with every query. Without it, a query that names no place is not limited to any area. For the full list of parameters, see the Place Search API reference.

Why Octen Place Search

Structured place data. Each place comes back as a card: address, coordinates, phone, website, opening hours, and rating.
Searches around the user. Pass the user’s coordinates or city, and the search runs around it. With coordinates, every card also carries its distance, and a radius keeps only the places within it.
Web results in the same call. Turn on web results to get pages about the same query alongside the cards.

For general web pages, use Web Search. For companies and people, use Business Search.

How It Works

Send a query with the location of the request: the user’s coordinates or city.
Octen finds the places that match the query around that location, or in the place the query names.
The response returns a place card for each place, plus ranked web results when you turn them on.

Scenarios

Find places nearby

Pass the user’s coordinates. Each card carries its distance in meters, and the radius keeps only the places within it.

curl -X POST https://api.octen.ai/place-search \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "query": "coffee shops",
    "latitude": 37.788,
    "longitude": -122.4075,
    "radius": 1000
  }'

Search by city

When you know only the user’s city, pass it as the user location. Distance is returned only with coordinates.

{
  "query": "coffee shops",
  "user_location": {
    "type": "approximate",
    "city": "Austin",
    "region": "Texas",
    "country": "US",
    "timezone": "America/Chicago"
  }
}

Search another area

When the user asks about somewhere else, name the place in the query. The search covers that place instead of the user’s location.

{
  "query": "ramen restaurants in Shinjuku, Tokyo",
  "latitude": 37.788,
  "longitude": -122.4075
}

Add web results

Get the place cards and the pages that discuss them in one call. The location applies to web results too, and highlights are on by default.

{
  "query": "family-friendly restaurants",
  "user_location": {
    "type": "approximate",
    "city": "Chicago",
    "region": "Illinois",
    "country": "US",
    "timezone": "America/Chicago"
  },
  "web_search": { "enable": true, "count": 5 }
}

Get the original text

For the complete page text of the web results, turn on full content.

{
  "query": "museums",
  "latitude": 51.5194,
  "longitude": -0.127,
  "web_search": {
    "enable": true,
    "full_content": { "enable": true, "max_tokens": 4000 }
  }
}

The full content of the first 10 results per search is free; only additional results are billed.

Next Steps

Try in Console

Run Place Search live in the Octen console.

Place Search API Reference

Full request/response schema.

Last modified on October 26, 2026

Overview

Capabilities

Integrations

Resources

Why Octen Place Search

How It Works

Scenarios

Find places nearby

Search by city

Search another area

Add web results

Get the original text

Next Steps

Try in Console

Place Search API Reference

​Why Octen Place Search

​How It Works

​Scenarios

​Find places nearby

​Search by city

​Search another area

​Add web results

​Get the original text

​Next Steps

Try in Console

Place Search API Reference

Why Octen Place Search

How It Works

Scenarios

Find places nearby

Search by city

Search another area

Add web results

Get the original text

Next Steps