> ## Documentation Index > Fetch the complete documentation index at: https://syncupai-robbalian-entrances-docs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 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 ## OpenAPI ````yaml https://api.reprompt.io/v2/openapi.json post /validate openapi: 3.1.0 info: title: Reprompt API v2 version: '2.0' servers: - url: https://api.reprompt.io/v2 description: V2 API server security: [] tags: - name: Enrichments description: Use AI to enrich place data with various attributes - name: Places description: Find, match, and check existence of places paths: /validate: post: tags: - Places summary: Validate Place description: >- 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 operationId: validate_place_validate_post parameters: - name: org_slug in: query required: false schema: anyOf: - type: string - type: 'null' title: Org Slug - name: apiKey in: header required: false schema: anyOf: - type: string - type: 'null' title: Apikey requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/V2PlaceValidationRequest' examples: ghost_kitchen_example: summary: Ghost kitchen with name and address value: name: Burger Den address: 12405 Westheimer Rd, Houston, TX 77077 starbucks_example: summary: Nearby match value: name: Starbucks address: Market and 8th st san francisco pizza_example: summary: Name and city only value: name: Apple address: San francisco apple_store_example: summary: Exact match value: name: Apple Store address: 300 post st San Francisco CA fictional_example: summary: Fictional place value: name: Hogwarts school of witchcraft and wizardry address: highlands, scotland, Great Britain address_only_example: summary: Address only (no name) value: address: 123 Main St, San Francisco, CA no_storefront_example: summary: No storefront value: name: Syncup AI Inc address: 201 3rd st, San Francisco, CA unusual_name_example: summary: Unusual name like store ID value: name: '!!!' address: 2507 r.fernandez, manila, philippines responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - bearerAuth: [] components: schemas: V2PlaceValidationRequest: properties: name: anyOf: - type: string - type: 'null' title: Name description: Business or place name address: anyOf: - type: string - type: 'null' title: Address description: Full address of the place type: object title: V2PlaceValidationRequest description: Request model for place existence endpoint HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: bearerAuth: type: http scheme: bearer description: 'Bearer token in the format: Bearer YOUR_API_KEY' ````