{
  "x402Version": 2,
  "id": 72136,
  "slug": "saylorinnovations-api-geocode-forward",
  "resource": "https://saylorinnovations.com/api/geocode/forward",
  "description": "Worldwide address and place geocoder on OpenStreetMap data - turns an address or place name into lat/lon with street, city, postcode, country and bounding box",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95877",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The query as the server interpreted it"
      },
      "count": {
        "type": "number",
        "description": "Number of items returned"
      },
      "results": {
        "type": "array",
        "description": "List of matching results"
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      }
    },
    "required": [
      "query",
      "results"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "limit": "2",
            "q": "Brandenburger Tor Berlin"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "query": "Brandenburger Tor Berlin",
            "count": 2,
            "results": [
              {
                "name": "Brandenburger Tor",
                "type": "attraction",
                "street": "Pariser Platz",
                "house_number": "1",
                "postcode": "10117",
                "city": "Berlin",
                "state": null,
                "country": "Deutschland",
                "country_code": "DE",
                "lat": 52.5162699,
                "lon": 13.3777034,
                "osm": "W/518071791",
                "extent": [
                  13.3775798,
                  52.5164328,
                  13.3778251,
                  52.516117
                ]
              },
              {
                "name": "Brandenburger Tor",
                "type": "station",
                "street": "Unter den Linden",
                "house_number": null,
                "postcode": "10117",
                "city": "Berlin",
                "state": null,
                "country": "Deutschland",
                "country_code": "DE",
                "lat": 52.5166047,
                "lon": 13.3809897,
                "osm": "N/3862767512",
                "extent": null
              }
            ],
            "source": "Photon geocoder over OpenStreetMap data (ODbL)"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "limit": {
                    "type": "string",
                    "description": "optional 1-10 (default 5)"
                  },
                  "q": {
                    "type": "string",
                    "description": "Address or place name, e.g. Brandenburger Tor Berlin"
                  }
                },
                "required": [
                  "q"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "description": "The query as the server interpreted it"
                  },
                  "count": {
                    "type": "number",
                    "description": "Number of items returned"
                  },
                  "results": {
                    "type": "array",
                    "description": "List of matching results"
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  }
                },
                "required": [
                  "query",
                  "results"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "geocode address to coordinates",
    "place name to lat lon",
    "forward geocoding api",
    "openstreetmap geocoder",
    "find coordinates of a city"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.856Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "string",
          "description": "optional 1-10 (default 5)"
        },
        "q": {
          "type": "string",
          "description": "Address or place name, e.g. Brandenburger Tor Berlin"
        }
      },
      "required": [
        "q"
      ]
    },
    "exampleResponse": {
      "query": "Brandenburger Tor Berlin",
      "count": 2,
      "results": [
        {
          "name": "Brandenburger Tor",
          "type": "attraction",
          "street": "Pariser Platz",
          "house_number": "1",
          "postcode": "10117",
          "city": "Berlin",
          "state": null,
          "country": "Deutschland",
          "country_code": "DE",
          "lat": 52.5162699,
          "lon": 13.3777034,
          "osm": "W/518071791",
          "extent": [
            13.3775798,
            52.5164328,
            13.3778251,
            52.516117
          ]
        },
        {
          "name": "Brandenburger Tor",
          "type": "station",
          "street": "Unter den Linden",
          "house_number": null,
          "postcode": "10117",
          "city": "Berlin",
          "state": null,
          "country": "Deutschland",
          "country_code": "DE",
          "lat": 52.5166047,
          "lon": 13.3809897,
          "osm": "N/3862767512",
          "extent": null
        }
      ],
      "source": "Photon geocoder over OpenStreetMap data (ODbL)"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "limit": "2",
              "q": "Brandenburger Tor Berlin"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "query": "Brandenburger Tor Berlin",
              "count": 2,
              "results": [
                {
                  "name": "Brandenburger Tor",
                  "type": "attraction",
                  "street": "Pariser Platz",
                  "house_number": "1",
                  "postcode": "10117",
                  "city": "Berlin",
                  "state": null,
                  "country": "Deutschland",
                  "country_code": "DE",
                  "lat": 52.5162699,
                  "lon": 13.3777034,
                  "osm": "W/518071791",
                  "extent": [
                    13.3775798,
                    52.5164328,
                    13.3778251,
                    52.516117
                  ]
                },
                {
                  "name": "Brandenburger Tor",
                  "type": "station",
                  "street": "Unter den Linden",
                  "house_number": null,
                  "postcode": "10117",
                  "city": "Berlin",
                  "state": null,
                  "country": "Deutschland",
                  "country_code": "DE",
                  "lat": 52.5166047,
                  "lon": 13.3809897,
                  "osm": "N/3862767512",
                  "extent": null
                }
              ],
              "source": "Photon geocoder over OpenStreetMap data (ODbL)"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "limit": {
                      "type": "string",
                      "description": "optional 1-10 (default 5)"
                    },
                    "q": {
                      "type": "string",
                      "description": "Address or place name, e.g. Brandenburger Tor Berlin"
                    }
                  },
                  "required": [
                    "q"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "query": {
                      "type": "string",
                      "description": "The query as the server interpreted it"
                    },
                    "count": {
                      "type": "number",
                      "description": "Number of items returned"
                    },
                    "results": {
                      "type": "array",
                      "description": "List of matching results"
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    }
                  },
                  "required": [
                    "query",
                    "results"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/geocode/forward?q=Brandenburger%20Tor%20Berlin&limit=2",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "query": "string",
    "count": 0,
    "results": [
      "value"
    ],
    "source": "string"
  }
}