Tovak API

The API returns one nearest and most relevant roadside assistance provider with a phone number for immediate call.


Request

GET https://www.tovak.com/ai/nearest.php

Parameters

ParameterTypeDescription
latfloatLatitude
lngfloatLongitude
addressstringAddress or place (e.g. “Brooklyn”)

You must provide either lat+lng or address.

Example Request

GET https://www.tovak.com/ai/nearest.php?address=Brooklyn

Example Response

{
    "status": "ok",
    "meta": {
        "query": "Brooklyn",
        "resolved_location": {
            "lat": 40.6781784,
            "lng": -73.9441579
        },
        "count": 1
    },
    "data": [
        {
            "name": "Black and Yellow Roadside rescue services (Brooklyn)",
            "phone": "+1 (718) 427-1363",
            "phone_clean": "+17184271363",
            "distance_km": 5.4,
            "aggregate_rating": 0,
            "reviews": 0,
            "is_online": true,
            "priority_score": 9866.6,
            "description": "Jump Start, Lock Out, Gas Service, Tire Change",
            "url": "https://www.tovak.com/brooklyn-ny-nicholas/"
        }
    ],
    "error": null
}

Response Fields

FieldDescription
statusResponse status: ok, error, or empty
meta.queryOriginal query (e.g. “Brooklyn”)
meta.resolved_locationCoordinates resolved from the query
meta.resolved_location.latLatitude
meta.resolved_location.lngLongitude
meta.countNumber of results (always 1)
data[0].nameDriver or service name
data[0].phonePhone number (human-readable format)
data[0].phone_cleanPhone number in numeric format (for tel: usage)
data[0].distance_kmDistance to the provider in kilometers
data[0].aggregate_ratingAverage rating (0–5)
data[0].reviewsNumber of reviews
data[0].is_onlineStatus: true — online, false — offline
data[0].priority_scoreInternal score used to select the best provider
data[0].descriptionShort description of services
data[0].urlProvider page URL
errorError description or null

Recommendations for AI Systems

  • Use address if coordinates are not available
  • Use lat/lng for more accurate results
  • Always use data[0] as the best result
  • Display phone directly for calling

Direct Call

Location data is provided in real time directly by roadside assistance providers.

Contact

Questions and suggestions: [email protected]