Validate Place

Validate if a place exists and has a digital footprint using AI-powered web search and analysis.

Given a place name and/or address, this endpoint performs comprehensive analysis to determine:

Digital Footprint Analysis:

• Web presence, social media accounts, official websites, and online mentions
• Strength of digital presence (HIGH, MEDIUM, LOW, NONE)

Entity Type Classification:

• Determines if the query represents a place, address only, person name, geographic area, or other entity type

Place Definition:

• Identifies the type of place: physical storefront, residential, temporary event, digital-only business (e.g., ghost kitchens, eCommerce), etc.

Place Reality - Location Match Granularity:

• house_number: Evidence found at exact address including street number (e.g., “123 Main St”)
• nearby: Evidence found on same street but without exact house number (e.g., “Main St” in same city)
• broad: Evidence found in general area/city but at different street or only partial address match
• none: Unable to match the place to any specific location

Input sensitivity: The achievable location_match_granularity depends on how specific the input is.

• Example — nearby: Input name=“Starbucks”, address=“123 main st san francisco” → location_match_granularity: nearby. Web sources may resolve this to an actual Starbucks at “5075 Main St, San Francisco”. We will still confirm the existence of “Starbucks, San Francisco” as a place: it DOES exist, it has HIGH internet presence, and it DOES have a storefront.
• Example — broad: Input name=“Starbucks”, address=“San Francisco” (name + city only) → location_match_granularity: broad. We can confirm the brand exists in the city, but without a specific street/house number from the input, the match stays broad.

Reprompt Validation Score:

• The reprompt_validation_score (1-9) provides an immediate assessment of whether a place is a legitimate, transactable commercial establishment. Use this score as a “first pass” filter before spending credits on deeper enrichments.

Use Cases:

• Filter out fraudulent places: Reject places with low scores before continuing with deeper enrichments.
• Identify non-commercial locations: Distinguish legitimate businesses with storefronts from legitimate non-commercial locations like parks, landmarks, or residential addresses.
• Verify commercial legitimacy: Ensure a business is a real operating entity before adding it to your database.

Scoring Rubric:

• Score 9: Walk-in commercial establishments such as retail stores, restaurants, cafes, bakeries with strong multi-source verification, clear operating hours, and confirmed customer visits.
• Score 8: Membership/appointment-based establishments. Gyms, fitness centers, salons, spas requiring membership or appointments.
• Score 7: Scheduled service businesses. HVAC companies, plumbers, electricians, contractors that operate by appointment and service calls.
• Score 6: Corporate offices and business headquarters. Not customer-facing but legitimate business operations.
• Score 5: Landmarks, parks, monuments. Verified public places but not commercial businesses. Maximum score for non-businesses.
• Score 4: Non-commercial infrastructure. Parking lots, garages, and utility structures that serve a function but are not destinations people visit for goods or services.
• Score 3: Residential addresses. Verified homes, apartments, or residential properties.
• Score 1-2: Minimal or weak evidence. Either found only on unreliable aggregator sites (score 2) or very weak/no verification (score 1).

Examples:

1. Walk-In Commercial - Bakery (Score 9)

• Name: Tartine Bakery
• Address: 600 Guerrero St, San Francisco, CA 94110
• Score: 9/10
• Reasoning: Near perfect score because it is a confirmed bakery/cafe with a physical storefront where customers walk in to purchase baked goods and dine. Strong digital presence with extensive reviews, hours, menu information, and consistent verification across multiple reliable sources.

2. Membership-Based - Gym (Score 8)

• Name: 24 Hour Fitness
• Address: 1200 Van Ness Ave, San Francisco, CA 94109
• Score: 8/10
• Reasoning: Scores an 8 because it is a verified gym with a physical location where customers visit, but typically requires membership. Strong digital presence with reviews, hours, and contact information across multiple sources.

3. Scheduled Service Business - Plumbing (Score 7)

• Name: One Source Plumbing and Rooter
• Address: 350 Bay St, Ste 100-178, San Francisco, CA 94133
• Score: 7/10
• Reasoning: Scores a 7 because it is a legitimate service business with good online verification, but it operates by appointment and service calls rather than as a walk-in storefront. Multiple directory listings confirm the business.

4. Corporate Office (Score 6)

• Name: Salesforce Tower
• Address: 415 Mission St, San Francisco, CA 94105
• Score: 6/10
• Reasoning: Scores a 6 because it is a verified corporate headquarters and office building with strong documentation, but not a customer-facing walk-in business location. Legitimate business operations but not open to general public.

5. Landmark/Park (Score 5)

• Name: Golden Gate Park
• Address: 501 Stanyan St, San Francisco, CA 94117
• Score: 5/10
• Reasoning: Scores a 5, the maximum for a non-business. It is clearly a real, visitable place (a famous park/landmark) with extensive documentation, but because it is not a commercial entity, it scores in the non-business category.

6. Non-Commercial Infrastructure - Parking (Score 4)

• Name: Sutter Stockton Garage
• Address: 444 Stockton St, San Francisco, CA 94108
• Score: 4/10
• Reasoning: Scores a 4 because it is a verified parking structure with some online presence, but serves purely as infrastructure. Not a destination people visit for goods or services beyond its utility function.

7. Residential Address (Score 3)

• Name: 81 Noe St
• Address: 81 Noe St, San Francisco, CA 94114
• Score: 3/10
• Reasoning: Scores a 3 because it is verified as a residential address. The address exists and can be found on real estate sites, but it is not a commercial establishment or business.

8. Minimal Low-Quality Presence (Score 2)

• Name: California Kitchen
• Address: 2400 W Holcombe Blvd, Houston, TX 77031
• Score: 2/10
• Reasoning: Scores a 2 because evidence exists only on unreliable aggregator sites with minimal verification. No presence on major platforms like Google Maps, Yelp, or official business directories.

9. Does Not Exist / Fake (Score 1)

• Name: LA Fitness
• Address: 5000 Westheimer Rd, Houston, TX 77063
• Score: 1/10
• Reasoning: Scores a 1 because the name + address combination cannot be found anywhere on reliable sources. While LA Fitness exists at other Houston locations (e.g., 9603 Westheimer Rd), there is no evidence of a location at 5000 Westheimer Rd.

Important Notes:

• This endpoint validates place existence and digital presence, but does NOT determine if a place is currently open or closed
• For open/closed status verification, use the closed_permanently enrichment via the /enrich endpoint

POST /validate

cURL

ghost_kitchen_example

curl --request POST \
  --url https://reprompt-mikhail--reprompt-fastapi-fastapi-app-dev.modal.run/v2/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Burger Den",
  "address": "12405 Westheimer Rd, Houston, TX 77077"
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer token in the format: Bearer YOUR_API_KEY

Headers

apiKey · string | null

Query Parameters

org_slug · string | null

Body

application/json

Request model for place existence endpoint

name · string | null

Business or place name

address · string | null

Full address of the place

Response

200

application/json

Successful Response