Skip to main content
POST
/
search
cURL
curl --request POST \
  --url https://api.embed.earth/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "query": "<string>",
  "limit": 2
}
'
{
  "isSuccess": true,
  "page": 1,
  "pageTotal": 1,
  "data": [
    {
      "id": "bdb35868-f007-4e04-a2ea-a5f887f66b85",
      "address": "28 Commonwealth Avenue, Boston, Massachusetts 02116, United States",
      "date": "August 2, 2024",
      "compass": "Facing Northeast (NE)",
      "interactive": false,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -71.072866805,
          42.353306626
        ]
      },
      "image": "https://storage.googleapis.com/download/storage/v1/b/fussydata/o/e12a868ca42641ee0d087e52e4ded167.jpg?generation=1770054919054519&alt=media"
    },
    {
      "id": "65e87d3b-0883-46b0-b4af-c07e230fc0a9",
      "address": "Unnamed Road, Boston, MA 02116, USA",
      "date": "August 17, 2023",
      "compass": "Facing East (E)",
      "interactive": false,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -71.0708196,
          42.354444444
        ]
      },
      "image": "https://storage.googleapis.com/download/storage/v1/b/fussydata/o/9472559a7fc23b2e81aae37770f02b49.jpg?generation=1771271564697201&alt=media"
    },
    {
      "id": "cf2cd3c4-2985-4b83-ad65-c5b4dbf60211",
      "address": "85 Beacon Street, Boston, Massachusetts 02108, United States",
      "date": "August 2, 2024",
      "compass": "Facing East (E)",
      "interactive": false,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -71.070539574,
          42.355551854
        ]
      },
      "image": "https://storage.googleapis.com/download/storage/v1/b/fussydata/o/e059188eb6fc42428c1e30310a7e74ec.jpg?generation=1770054913452720&alt=media"
    },
    {
      "id": "ffd51abe-079c-4263-9fc6-c11a3c422c1d",
      "address": "9W3H+W6, Boston, MA, USA",
      "date": "August 2, 2024",
      "compass": "Facing Northeast (NE)",
      "interactive": false,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -71.071935601,
          42.354765768
        ]
      },
      "image": "https://storage.googleapis.com/download/storage/v1/b/fussydata/o/ffb3f5358ed92d2835658ca1597b8d39.jpg?generation=1770055059722916&alt=media"
    },
    {
      "id": "02d3955c-ce6f-41fa-b528-6ddbe1f3de9c",
      "address": "9W4H+8W, Boston, MA, USA",
      "date": "August 5, 2024",
      "compass": "Facing Southeast (SE)",
      "interactive": false,
      "geometry": {
        "type": "Point",
        "coordinates": [
          -71.070178575,
          42.355787025
        ]
      },
      "image": "https://storage.googleapis.com/download/storage/v1/b/fussydata/o/430b8a72c804256c30265a5acce5d9bf.jpg?generation=1769386502589952&alt=media"
    }
  ],
  "result_id": "a4d72775-8569-4d38-82c3-bde130abfd6d",
  "region": "Global",
  "region_id": null
}

Authorizations

x-api-key
string
header
required

API key required for all E2 resources.

Headers

x-api-key
string
required

API key used to authorize the request

Body

application/json
query
string

Search term for address or place

limit
integer

Optional number of results to return

Required range: x >= 1

Response

200 - application/json

Search results response

isSuccess
boolean
page
integer
pageTotal
integer
data
object[]
result_id
string
region
string
region_id
string | null