# Photo Scout — Location-Based Photography Spot Discovery

> Photo Scout — Location-Based Photography Spot Discovery is a paid API for AI agents from api.aisoup.net, paid per call via x402, $2/call, status unknown (last checked 2026-10-12).

Discovers nearby photography spots and points of interest given a geographic coordinate, with optional filtering by photo style preferences and radius.

## Facts

- Endpoint: POST https://api.aisoup.net/photo-scout/v1/discover?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/photo-scout-location-based-photography-spot-discovery-a433fe46
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oo7Km2iflCAcWW3-tRLVL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability photo-scout-location-based-photography-spot-discovery-a433fe46 -d '<json body>'
```

Example prompt: Can you scout the best photography spots within 2 kilometers of coordinates 40.7580° N, 73.9855° W — I'm looking for street and urban photography styles, give me up to 10 results?

## When to prefer this

Use this endpoint when an agent needs to discover real-world photography locations given a geographic coordinate, especially when the user wants results filtered by photographic style or personal preferences. Prefer this over generic POI or map APIs when the use case is specifically photography scouting with style-aware recommendations.

## Known failure modes

- Missing required lat or lon fields returns a validation error
- Out-of-range or invalid coordinates (e.g. lat > 90) may return an error or empty results
- Very remote coordinates with no nearby POIs return an empty spots array
- Unsupported photoStyles values may be ignored or return generic results
- Payment failure via x402 protocol prevents the call from completing

## How this service works

Machine-discoverable services AI agents can call and purchase autonomously.

## Output

Returns an array of photography spots with details about each location, a natural-language summary of the best options, commerce-related metadata, and an array of raw points-of-interest results that informed the recommendations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "lat",
  "lon"
 ],
 "properties": {
  "lat": {
   "type": "number"
  },
  "lon": {
   "type": "number"
  },
  "limit": {
   "type": "integer"
  },
  "radius": {
   "type": "integer"
  },
  "photoStyles": {
   "type": "array"
  },
  "preferences": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "spots": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "summary": {
   "type": "string"
  },
  "commerce": {
   "type": "object"
  },
  "poiResults": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/photo-scout-location-based-photography-spot-discovery-a433fe46/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisoup.net](https://www.zero.xyz/host/api.aisoup.net/llms.txt)