Geoapify Places
Live geocoding and nearby venue discovery. Each result retains source timestamp and required provider/map attribution.
Geoapify · OpenStreetMap← Pizza Finder›Live response sample
LIVE DATA · FREE PREVIEW
Pizza Finder response
Live pizza discovery for the United Kingdom and the United States using country-filtered Geoapify Places. UK results may be enriched with uniquely matched, date-stamped Food Standards Agency hygiene data.
payment=false5 requests/minute/IPRead-only · no ordering
Sample and data limits
This response is a real captured sample, not a current availability guarantee. Distance is straight-line from the postcode centroid. Price, delivery fee, menu, customer rating and ETA are unknown. An FSA rating is not a customer review and its rating date is shown; FSA data is GB-only.
Supported countries and postcode warning
Live venue discovery currently supports the United Kingdom (country=GB) and the United States (country=US). The API and website are available globally, but data coverage is not worldwide. Always pair the postcode or ZIP code with its correct country. A successfully completed paid request is not refunded when you provide the wrong country or postcode.
Latest daily live samples
One public query is refreshed daily and retained for up to 30 days. Samples are examples, not a guarantee of current availability.
Loading daily samples…
Run a live query
Use the REST endpoint directly; no key, payment or wallet required for the free preview. Set the country explicitly to avoid ambiguity.
curl -sS 'https://api.niftibot.com/v1/search?postcode=SW1A%201AA&country=GB&mode=balanced&max_results=5&payment=false' | jq .curl -sS 'https://api.niftibot.com/v1/search?postcode=10001&country=US&mode=balanced&max_results=5&payment=false' | jq .AI-agent prompt
Use the Niftibot Pizza Finder service, not general web search. Choose country=GB for a UK postcode or country=US for a US ZIP code; confirm the country/postcode pair before querying. Call the live API with payment=false. Do not request or send payment. Return the complete JSON, preserve source attribution and any GB FSA rating dates, explain unknown price/ETA/availability, and state that this service does not order food. Successfully completed paid requests are not refunded for input mistakes. If the endpoint fails, report that and stop.Read Pizza Finder agent instructions Test a paid request with Stripe test credits
Complete sample JSON
Captured from a real Geoapify and FSA-backed query. Download the JSON or schema.
SW1A 1AA · captured 2026-10-27T16:52:31.705Z
{
"schema": "niftibot-pizza-finder-sample/v1",
"is_sample": true,
"captured_at": "2026-10-27T16:52:31.705Z",
"request": {
"method": "GET",
"url": "https://api.niftibot.com/v1/search?postcode=SW1A%201AA&mode=balanced&max_results=5&payment=false",
"postcode": "SW1A 1AA",
"mode": "balanced",
"max_results": 5,
"payment": false
},
"data": {
"postcode": "SW1A 1AA",
"results": [
{
"rank": 1,
"score": {
"price": null,
"speed": null,
"quality": null,
"distance": 0.9172969179524568,
"availability": null,
"confidence": 0.2,
"provider_trust": 0.7142857142857143,
"latency": 0.41231975529527215,
"final_score": 0.20377425098858074,
"reasons": [
"price=unknown; contributes zero",
"speed=unknown; contributes zero",
"quality=unknown; contributes zero",
"distance=0.917; weight=0.10",
"availability=unknown; contributes zero",
"confidence=0.200; weight=0.10",
"provider_trust=0.714; weight=0.10",
"latency=0.412; weight=0.05",
"fees unknown: total cost cannot be compared"
]
},
"place": {
"offer_id": "cd74b3fdd6c4bea61187cb5ab41af23789c0fc4b7035c5e9f9a37df1debde5a2",
"provider_id": "geoapify",
"seller_name": "Franco Manca",
"title": "Franco Manca",
"description": "Franco Manca, 7 Sir Simon Milton Square, London, SW1E 5DJ, United Kingdom",
"location": {
"text": "Franco Manca, 7 Sir Simon Milton Square, London, SW1E 5DJ, United Kingdom",
"country_code": "GB",
"postcode": "SW1E 5DJ"
},
"distance_km": 0.450797775665423,
"price": null,
"price_confidence": null,
"delivery_cost": null,
"eta_minutes": null,
"rating": null,
"review_count": null,
"quality_signals": {
"attribution": "Powered by Geoapify | © OpenStreetMap contributors",
"distance_method": "straight-line from postcode centroid; not road distance",
"timestamp_meaning": "retrieved_at; source update time unknown",
"fsa:rating_value": "5",
"fsa:scheme": "FHRS",
"fsa:reference": "fsa:establishment:1073478",
"fsa:retrieved_at": "2026-10-27T16:52:31.579213+00:00",
"fsa:match": "unique exact normalized name and postcode",
"fsa:attribution": "Food Standards Agency open data",
"fsa:rating_date": "2024-01-19T00:00:00"
},
"availability": "unknown",
"provider_trust": 0.7142857142857143,
"data_confidence": null,
"source_timestamp": "2026-10-27T16:52:31.533227Z",
"quote_kind": "discovery_estimate"
}
},
{
"rank": 2,
"score": {
"price": null,
"speed": null,
"quality": null,
"distance": 0.9108288848085215,
"availability": null,
"confidence": 0.2,
"provider_trust": 0.7142857142857143,
"latency": 0.41231975529527215,
"final_score": 0.20312744767418722,
"reasons": [
"price=unknown; contributes zero",
"speed=unknown; contributes zero",
"quality=unknown; contributes zero",
"distance=0.911; weight=0.10",
"availability=unknown; contributes zero",
"confidence=0.200; weight=0.10",
"provider_trust=0.714; weight=0.10",
"latency=0.412; weight=0.05",
"fees unknown: total cost cannot be compared"
]
},
"place": {
"offer_id": "e6028cfd572bfca1c67878fa6e34c4e8e498570cc238406c898a02c70924de1b",
"provider_id": "geoapify",
"seller_name": "Pizza Pilgrims",
"title": "Pizza Pilgrims",
"description": "Pizza Pilgrims, 32 Buckingham Palace Road, London, SW1W 0RE, United Kingdom",
"location": {
"text": "Pizza Pilgrims, 32 Buckingham Palace Road, London, SW1W 0RE, United Kingdom",
"country_code": "GB",
"postcode": "SW1W 0RE"
},
"distance_km": 0.48950531037574885,
"price": null,
"price_confidence": null,
"delivery_cost": null,
"eta_minutes": null,
"rating": null,
"review_count": null,
"quality_signals": {
"attribution": "Powered by Geoapify | © OpenStreetMap contributors",
"distance_method": "straight-line from postcode centroid; not road distance",
"timestamp_meaning": "retrieved_at; source update time unknown",
"fsa:rating_value": "5",
"fsa:scheme": "FHRS",
"fsa:reference": "fsa:establishment:772582",
"fsa:retrieved_at": "2026-10-27T16:52:31.607802+00:00",
"fsa:match": "unique exact normalized name and postcode",
"fsa:attribution": "Food Standards Agency open data",
"fsa:rating_date": "2023-09-12T00:00:00"
},
"availability": "unknown",
"provider_trust": 0.7142857142857143,
"data_confidence": null,
"source_timestamp": "2026-10-27T16:52:31.533279Z",
"quote_kind": "discovery_estimate"
}
},
{
"rank": 3,
"score": {
"price": null,
"speed": null,
"quality": null,
"distance": 0.8872732948971505,
"availability": null,
"confidence": 0.2,
"provider_trust": 0.7142857142857143,
"latency": 0.41231975529527215,
"final_score": 0.2007718886830501,
"reasons": [
"price=unknown; contributes zero",
"speed=unknown; contributes zero",
"quality=unknown; contributes zero",
"distance=0.887; weight=0.10",
"availability=unknown; contributes zero",
"confidence=0.200; weight=0.10",
"provider_trust=0.714; weight=0.10",
"latency=0.412; weight=0.05",
"fees unknown: total cost cannot be compared"
]
},
"place": {
"offer_id": "37874b7846f2d0555f2209dde98bb7abac95b5f1fdc123079abc4bd9617c5eda",
"provider_id": "geoapify",
"seller_name": "PizzaExpress",
"title": "PizzaExpress",
"description": "PizzaExpress, 154 Victoria Street, London, SW1E 5LB, United Kingdom",
"location": {
"text": "PizzaExpress, 154 Victoria Street, London, SW1E 5LB, United Kingdom",
"country_code": "GB",
"postcode": "SW1E 5LB"
},
"distance_km": 0.6352422965458254,
"price": null,
"price_confidence": null,
"delivery_cost": null,
"eta_minutes": null,
"rating": null,
"review_count": null,
"quality_signals": {
"attribution": "Powered by Geoapify | © OpenStreetMap contributors",
"distance_method": "straight-line from postcode centroid; not road distance",
"timestamp_meaning": "retrieved_at; source update time unknown"
},
"availability": "unknown",
"provider_trust": 0.7142857142857143,
"data_confidence": null,
"source_timestamp": "2026-10-27T16:52:31.533301Z",
"quote_kind": "discovery_estimate"
}
},
{
"rank": 4,
"score": {
"price": null,
"speed": null,
"quality": null,
"distance": 0.8679864864620371,
"availability": null,
"confidence": 0.2,
"provider_trust": 0.7142857142857143,
"latency": 0.41231975529527215,
"final_score": 0.19884320783953877,
"reasons": [
"price=unknown; contributes zero",
"speed=unknown; contributes zero",
"quality=unknown; contributes zero",
"distance=0.868; weight=0.10",
"availability=unknown; contributes zero",
"confidence=0.200; weight=0.10",
"provider_trust=0.714; weight=0.10",
"latency=0.412; weight=0.05",
"fees unknown: total cost cannot be compared"
]
},
"place": {
"offer_id": "fb73166373115e124c9486040615a4af42b36775b4492aeedf3ccdfbb2c327d8",
"provider_id": "geoapify",
"seller_name": "Pizzetta",
"title": "Pizzetta",
"description": "Pizzetta, Greycoat Place, London, SW1P 1WU, United Kingdom",
"location": {
"text": "Pizzetta, Greycoat Place, London, SW1P 1WU, United Kingdom",
"country_code": "GB",
"postcode": "SW1P 1WU"
},
"distance_km": 0.7604583458208983,
"price": null,
"price_confidence": null,
"delivery_cost": null,
"eta_minutes": null,
"rating": null,
"review_count": null,
"quality_signals": {
"attribution": "Powered by Geoapify | © OpenStreetMap contributors",
"distance_method": "straight-line from postcode centroid; not road distance",
"timestamp_meaning": "retrieved_at; source update time unknown"
},
"availability": "unknown",
"provider_trust": 0.7142857142857143,
"data_confidence": null,
"source_timestamp": "2026-10-27T16:52:31.533320Z",
"quote_kind": "discovery_estimate"
}
},
{
"rank": 5,
"score": {
"price": null,
"speed": null,
"quality": null,
"distance": 0.8350008673693098,
"availability": null,
"confidence": 0.2,
"provider_trust": 0.7142857142857143,
"latency": 0.41231975529527215,
"final_score": 0.19554464593026605,
"reasons": [
"price=unknown; contributes zero",
"speed=unknown; contributes zero",
"quality=unknown; contributes zero",
"distance=0.835; weight=0.10",
"availability=unknown; contributes zero",
"confidence=0.200; weight=0.10",
"provider_trust=0.714; weight=0.10",
"latency=0.412; weight=0.05",
"fees unknown: total cost cannot be compared"
]
},
"place": {
"offer_id": "cebf259bf9e05855d11d5eabdf3d3550491fc672ba900543f12d5b85bec6e684",
"provider_id": "geoapify",
"seller_name": "Domino's",
"title": "Domino's",
"description": "Domino's, 17 Warwick Way, London, SW1V 1QT, United Kingdom",
"location": {
"text": "Domino's, 17 Warwick Way, London, SW1V 1QT, United Kingdom",
"country_code": "GB",
"postcode": "SW1V 1QT"
},
"distance_km": 0.988017731948734,
"price": null,
"price_confidence": null,
"delivery_cost": null,
"eta_minutes": null,
"rating": null,
"review_count": null,
"quality_signals": {
"attribution": "Powered by Geoapify | © OpenStreetMap contributors",
"distance_method": "straight-line from postcode centroid; not road distance",
"timestamp_meaning": "retrieved_at; source update time unknown"
},
"availability": "unknown",
"provider_trust": 0.7142857142857143,
"data_confidence": null,
"source_timestamp": "2026-10-27T16:52:31.533339Z",
"quote_kind": "discovery_estimate"
}
}
],
"recommendation": {
"score": {
"price": null,
"speed": null,
"quality": null,
"distance": 0.9172969179524568,
"availability": null,
"confidence": 0.2,
"provider_trust": 0.7142857142857143,
"latency": 0.41231975529527215,
"final_score": 0.20377425098858074,
"reasons": [
"price=unknown; contributes zero",
"speed=unknown; contributes zero",
"quality=unknown; contributes zero",
"distance=0.917; weight=0.10",
"availability=unknown; contributes zero",
"confidence=0.200; weight=0.10",
"provider_trust=0.714; weight=0.10",
"latency=0.412; weight=0.05",
"fees unknown: total cost cannot be compared"
]
},
"place": {
"offer_id": "cd74b3fdd6c4bea61187cb5ab41af23789c0fc4b7035c5e9f9a37df1debde5a2",
"seller_name": "Franco Manca",
"distance_km": 0.450797775665423
}
},
"ranking_explanation": "Highest weighted score in balanced mode; unknown components contribute zero. Ties use provider ID then offer ID.",
"confidence": 0.2,
"execution": "PREVIEW_ONLY"
},
"service": {
"slug": "pizza-finder",
"version": "0.3.0"
},
"attribution": "Places © OpenStreetMap contributors (ODbL) via Geoapify; food hygiene ratings © Food Standards Agency (OGL v3)",
"licence": {
"status": "open_data",
"note": "OpenStreetMap (ODbL) via Geoapify, FSA FHRS (Open Government Licence v3). Unknown price/ETA stay null; never invented."
},
"retrieved_at": "2026-10-27T16:52:31.705Z",
"payment": {
"required": false,
"mode": "free_demo"
},
"request_id": "015755a6-8c0d-481e-a222-cb09f9ae6ce4",
"sources": [
{
"name": "Geoapify Places",
"url": "https://www.geoapify.com/places-api/",
"licence": "Geoapify plan terms; Geoapify and OpenStreetMap attribution required"
},
{
"name": "Food Standards Agency FHRS/FHIS API",
"url": "https://api.ratings.food.gov.uk/help",
"licence": "Open Government Licence v3.0"
}
],
"caveats": [
"Live response captured from the public Niftibot Pizza Finder API; it is not a current availability guarantee.",
"Price, fees, menu, ETA, customer reviews and availability are unknown unless explicitly sourced.",
"Distance is straight-line from postcode centroid, not road or delivery distance.",
"FSA rating is attached only on a unique name/postcode match and is not a customer review; inspect its rating date.",
"Ranking is a transparent discovery heuristic, not a quality or fulfilment guarantee.",
"Discovery only: the service does not order food, reserve tables or provide allergen advice."
]
}What is aggregated and why
Food Standards Agency
Optional hygiene rating evidence, attached only when venue name and postcode match uniquely. Rating and source retrieval dates are included.
FSA open data · OGL v3Benefits of one attributable response
- One API call combines venue discovery and available official hygiene evidence.
- Structured data makes candidates, unknowns, ranking reasons and provenance usable by an agent or application.
- Explicit limitations prevent the response from implying a live quote, delivery promise or food-safety guarantee.
Attribution: Powered by Geoapify · © OpenStreetMap contributors · Food Standards Agency open data. Geoapify plan limits and attribution apply. FSA ratings may be older than the query and can change after inspection.