https://github.com/jackdriscoll13/automotive_lead_engine
A web app that generates sales leads for an automotive company.
https://github.com/jackdriscoll13/automotive_lead_engine
fastapi google-places-api python pythongenerator react streaming-api tailwindcss
Last synced: 2 months ago
JSON representation
A web app that generates sales leads for an automotive company.
- Host: GitHub
- URL: https://github.com/jackdriscoll13/automotive_lead_engine
- Owner: JackDriscoll13
- Created: 2024-07-07T20:41:03.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-18T22:34:35.000Z (over 1 year ago)
- Last Synced: 2025-07-02T03:39:03.647Z (12 months ago)
- Topics: fastapi, google-places-api, python, pythongenerator, react, streaming-api, tailwindcss
- Language: JavaScript
- Homepage: https://www.qfresheners.com/leads
- Size: 226 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Overview
**Summary:**
This is the codebase for [qfresheners.com/leads](https://www.qfresheners.com/leads).
The primary purpose of this application is to generate leads for a company that sells ancillary items to automotive businesses. The app allows sales people to quickly explore locations and generate long sheets of leads that can be used to contact businesses or fed into CRM tools.
The intended user base is extremley small (2-4 people).
The application is publicly deployed for ease of use and because there is limited potnetial for abuse.
**Tech Stack:**
The frontend is React JS, Tailwind CSS, and Chart JS (react-chart-js2) for the Analytics Chart.
The backend is built in python with FastApi.
**Core App:**
This applicaiton uses 3 endpoints from the new Google Places API to collect information on businesses through different means.
The Location Search Feature uses the [text search](https://developers.google.com/maps/documentation/places/web-service/text-search) endpoint to find businesses given a text query and a location. This feature is built in a minimal way and is basically a glorified wrapper on the text search endpoint.
The Zip Code Search feature combines google's [geocoding api](https://developers.google.com/maps/documentation/geocoding/overview) and the [nearby search](https://developers.google.com/maps/documentation/places/web-service/nearby-search) to search businesses in a list of zip codes. This enables users to search up to 50 zip codes at a time. It also enables high resolution using a radius users can customize. This feature uses a python generator to stream data in real time to the frontend via FastApi's streaming response model.
I reccomend playing with the application to get a feel for how it works before diving into the code. The analytics page is helpful for understanding how many api calls you are making with each search.
Or if you're a psycopath you can read the docs I wrote for my future self. They can be found in [docs/docs.md](docs/docs.md)