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

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

Places

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 --request POST \
  --url https://api.reprompt.io/v2/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Burger Den",
  "address": "12405 Westheimer Rd, Houston, TX 77077"
}
'

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

Authorizations

Authorization

string

header

required

Bearer token in the format: Bearer YOUR_API_KEY

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

Successful Response

List Attributes

Placematch

⌘I

V2 API Reference

Guides

Validate Place

Authorizations

Body

Response