Marvin2 API Documentation
Marvin2 API Changelog
Stay updated with the latest changes and improvements to the Marvin2 API.
Version 1.2.1
Added optional 'description' field to /marvin2 endpoint request body.
Feature
•The /marvin2 endpoint now accepts an optional 'description' field in the request body (up to 300 characters).
•This field can be used to provide additional business context, which may improve the accuracy of our search algorithm.
•If provided, the 'description' should be a free-text string (max 300 characters) describing the business, its services, or any other relevant details.
Version 1.2.0
Introduced the new `/co-tenant` endpoint for location-based business intelligence.
Feature
•Introduced the `/co-tenant` endpoint that provides information about businesses sharing the same physical location or building.
•Enables users to identify other businesses operating at the same address for market research, competitive analysis, and location intelligence.
•Provides geocoding information with precise latitude and longitude coordinates for the queried location.
•Includes building structure data with polygon representations for spatial analysis.
•Supports detailed business categorization with top categories, subcategories, and category tags.
•Returns brand information including brand names and unique brand identifiers for chain businesses.
•Includes contact details such as phone numbers and associated domain names for each tenant.
Example Co-Tenant Request and Response
Request
{
"address": "11025 Carolina Place Pkwy",
"city": "Pineville",
"state": "NC",
"postal": "28134"
}Response
{
"geocode": {
"lat": 35.08225579999999,
"lng": -80.8773368
},
"structure": {
"structure_polygon": "POLYGON ((-80.87688135199994 35.08437577900003, ...))"
},
"tenants": [
{
"placekey": "zzw-222@8gf-dqc-8vz",
"location_name": "Sbarro",
"brand_name": "Sbarro",
"brand_id": "SG_BRAND_b9753c942e2efa5e5051a57e7d12c9bb",
"naics_code": "722513",
"top_category": "Restaurants and Other Eating Places",
"sub_category": "Limited-Service Restaurants",
"category_tags": "[\"Cafeteria\", \"Counter Service\", \"Dinner\", \"Italian Food\", \"Lunch\", \"Pizza\"]",
"latitude": 35.082355,
"longitude": -80.876994,
"street_address": "11025 Carolina Place Pkwy",
"city": "Pineville",
"region": "NC",
"postal_code": "28134",
"open_hours": "{ \"Mon\": [[\"11:00\", \"19:00\"]], \"Tue\": [[\"11:00\", \"19:00\"]], \"Wed\": [[\"11:00\", \"19:00\"]], \"Thu\": [[\"11:00\", \"19:00\"]], \"Fri\": [[\"11:00\", \"20:00\"]], \"Sat\": [[\"11:00\", \"20:00\"]], \"Sun\": [[\"12:00\", \"18:00\"]] }",
"domains": "[\"sbarro.com\"]",
"phone_number": "+17045439559"
}
]
}Version 1.1.0
Renamed 'confidence' to 'accuracy' in /marvin2 NAICS prediction response.
Breaking Change
•The `confidence` field within the prediction_a` and `prediction_b` objects returned by the `/marvin2` endpoint has been renamed to `accuracy`. This change was made to support backwards compatibility with the previous marvin API.
Example Response Change
Before
{
"code": "541511",
"title": "Custom Computer Programming Services",
"confidence": 0.78
}After
{
"code": "541511",
"title": "Custom Computer Programming Services",
"accuracy": 0.78
}