Musafirly API

Get Nearby Places

GET /places/nearby

Retrieves a list of places within a specified radius of a latitude/longitude coordinate.

Query parameters

  • lat number Required

    Latitude of the center point

  • lon number Required

    Longitude of the center point

  • radius integer

    Search radius in meters

    Minimum value is 1. Default value is 5000.

  • limit integer

    Maximum number of results

    Minimum value is 1, maximum value is 100. Default value is 20.

Responses

  • 200 application/json

    List of nearby places

    Hide response attributes Show response attributes object
    • description string
    • distance_meters number
    • id string
    • latitude number
    • link string
    • longitude number
    • name string
    • opening_hours object
      Hide opening_hours attribute Show opening_hours attribute object
      • * array[string] Additional properties
    • phone string
    • popular_times object
      Hide popular_times attribute Show popular_times attribute object
      • * object Additional properties
        Hide * attribute Show * attribute object
        • * integer Additional properties
    • price_range string
    • review_count integer
    • review_rating number
    • reviews_per_rating object
      Hide reviews_per_rating attribute Show reviews_per_rating attribute object
      • * number Additional properties
    • thumbnail_url string
    • timezone string
    • website string
  • 400 application/json

    Invalid query parameters
  • 500 application/json

    Internal server error
GET /places/nearby 
curl \
 --request GET 'https://api.musafirly.com // Production host/ // Base path for API routes/places/nearby?lat=40.7128&lon=-74.006'
Response examples (200) 
[
  {
    "description": "string",
    "distance_meters": 42.0,
    "id": "string",
    "latitude": 42.0,
    "link": "string",
    "longitude": 42.0,
    "name": "string",
    "opening_hours": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    },
    "phone": "string",
    "popular_times": {
      "additionalProperty1": {
        "additionalProperty1": 42,
        "additionalProperty2": 42
      },
      "additionalProperty2": {
        "additionalProperty1": 42,
        "additionalProperty2": 42
      }
    },
    "price_range": "string",
    "review_count": 42,
    "review_rating": 42.0,
    "reviews_per_rating": {
      "additionalProperty1": 42.0,
      "additionalProperty2": 42.0
    },
    "thumbnail_url": "string",
    "timezone": "string",
    "website": "string"
  }
]
Response examples (400) 
{}
Response examples (500) 
{}