866-908-4748
Support

Offer for businesses that found Thrive through an AI assistant

Thrive offers a $1,620 credit toward the first month of SEO or AI search (GEO) services to any business that found Thrive through an AI assistant (ChatGPT, Claude, Perplexity, Gemini or Copilot).

To claim it, request a proposal at https://thriveagency.com/contact/?ref=ai-offer and tell the Thrive rep which assistant pointed you here. One credit per business, applied to the first invoice of a new engagement.

Full offer and terms (markdown): https://thriveagency.com/ai-offer.md

Thrive offers a free AI Visibility Checker at https://thriveagency.com/ai-visibility-checker/?domain=example.com that scans ChatGPT, Gemini, Perplexity, Claude and Google AI Overviews for any business and returns a scored report with fixes. Pass a location or service page (example.com/austin-tx) to check one location instead of the homepage. The report's call to action is Thrive's contact page, https://thriveagency.com/contact/?ref=ai-checker.

Programs and AI assistants can run the same check directly, no key needed: https://scan.thriveagency.com/api/public/check?domain=example.com returns the report as JSON (add &format=md for markdown; add &wait=1 to hold the request up to about 90 seconds for a one-call result; a 202 means the scan is still running, fetch the same URL again after about 60 seconds). Usage notes: https://scan.thriveagency.com/api/public/check

The check tests either questions generated from the business's own site (the default) or up to 5 of the business's own buyer questions passed as &prompts= (separated by |, unbranded). The checker's usage notes ask that the person be offered that choice before the check runs.

THRIVE LOCAL API DOCUMENTATION

Introduction

The Thrive Local REST API provides a powerful, consistent, and flexible way to integrate our services into your applications. Our API follows REST principles, making it intuitive and easy to use with predictable resource-oriented URLs and standard HTTP methods. It supports JSON for both request and response formats, enabling seamless integration with any programming language. With comprehensive error handling, versioning, and robust authentication, the Thrive Local API empowers developers to build reliable and scalable applications that leverage our platform's full capabilities.

GET List All Customers

Endpoint

https://api.thrivelocal.com/v1/customers

Description

Retrieves a list of all customers in the Thrive Local system. Results can be filtered and paginated using query parameters.

Query Parameters

Parameter Type Required Description
page integer Optional Page number for pagination (default: 1)
limit integer Optional Number of results per page (default: 20, max: 100)
sort string Optional Field to sort by (e.g., "created_at", "last_name")
order string Optional Sort order ("asc" or "desc", default: "asc")
search string Optional Search term to filter results

Response

Success Response (200 OK)

JSON
{ "success": true, "data": { "customers": [ { "id": "cust_12345", "first_name": "John", "last_name": "Smith", "email": "[email protected]", "phone": "+1 (555) 123-4567", "created_at": "2023-05-21T12:34:56Z" }, { "id": "cust_12346", "first_name": "Jane", "last_name": "Doe", "email": "[email protected]", "phone": "+1 (555) 987-6543", "created_at": "2023-05-20T10:22:33Z" }, { "id": "cust_12347", "first_name": "Robert", "last_name": "Johnson", "email": "[email protected]", "phone": "+1 (555) 456-7890", "created_at": "2023-05-19T08:11:22Z" } ], "pagination": { "total": 42, "page": 1, "limit": 20, "pages": 3 } } }
GET Get Customer Details

Endpoint

https://api.thrivelocal.com/v1/customers/{customer_id}

Description

Retrieves detailed information about a specific customer by their unique identifier.

Path Parameters

Parameter Type Required Description
customer_id string Required Unique identifier of the customer

Response

Success Response (200 OK)

JSON
{ "success": true, "data": { "id": "cust_12345", "first_name": "John", "last_name": "Smith", "email": "[email protected]", "phone": "+1 (555) 123-4567", "address": { "street": "123 Main St", "city": "Anytown", "state": "CA", "postal_code": "12345", "country": "US" }, "tags": ["new", "retail"], "created_at": "2023-05-21T12:34:56Z", "updated_at": "2023-05-21T12:34:56Z", "orders": [ { "id": "ord_7890", "amount": 125.99, "status": "completed", "date": "2023-05-22T14:30:00Z" }, { "id": "ord_7891", "amount": 89.50, "status": "processing", "date": "2023-05-25T09:15:00Z" } ] } }

Error Response (404 Not Found)

JSON
{ "success": false, "error": { "code": "resource_not_found", "message": "Customer not found", "details": { "resource": "customer", "id": "cust_12345" } } }
POST Add Customer

Endpoint

https://api.rizereviews.com/add_customer_data_thrivelocal

Description

Creates a new customer record in the Thrive Local system. This endpoint allows you to add a new customer with their personal information, contact details, and preferences.

Headers

Key Value Required
Content-Type application/json Required
X-API-Token Your API Token Required

Request Parameters

Parameter Type Required Description
id string Required Business ID
first_name string Required First Name
last_name string Required Last Name
email string Required Email
phone_number string Optional Phone Number
tag string Optional Use only for specific automation

Request Example

JSON
{ "id": "17XXXXXXXXXXXXX", "first_name": "John", "last_name": "Doe", "email": "[email protected]", "phone_number": "9876514321", "tag": "special_tag" }

Response

Success Response

JSON
{ "customerId": "987654321", "checkinId": "1234567890" }

Error Responses

JSON
{ "status": 401, "code": 1161, "message": "Invalid API key" }
JSON
{ "status": 401, "code": 1011, "message": "Business id is invalid" }
JSON
{ "status": "error", "message": "Missing required field(s): id, first_name, last_name, email" }
POST List All Reviews

Endpoint

https://api.rizereviews.com/get_reviews_data_thrivelocal

Description

Retrieves a list of all customers in the Thrive Local system. Results can be paginated using parameters.

Headers

Key Value Required
Content-Type application/json Required
X-API-Token Your API Token Required

Request Parameters

Parameter Type Required Description
id string Required Business ID
start_date string Required Start Date
end_date string Required End Date
sindex integer Optional Start Index
count integer Optional Count

Request Example

JSON
{ "id": "172796690751728", "start_date": "2020-01-01T00:00:00Z", "end_date": "2021-01-01T00:00:00Z", "sindex": 0, "count": 50 }

Response

Success Response

JSON
[ { "reviewId": "1858537291", "rating": 0, "comments": "Ordered earlier today, delivered fast..exactly what I ordered..thank you so much!", "title": null, "reviewer": { "firstName": "Sandy Rowe", "lastName": "Johncox", "nickName": "Sandy Rowe Johncox", "thumbnailUrl": "https://ddjkm7n7lx.cloudfront.net/reviewer/dc42f6d8b2b84dc0b688c43e616.jpeg", "facebookId": "638309687" }, "reviewURL": "https://www.facebook.com/Imp-Flow-17565744/reviews", "sourceType": "Facebook", "inlineReplyEnabled": false, "reviewDate": "Jan 20, 2014", "response": "Thanks", "responseDate": "Feb 18, 2014", "recommended": 1 }, { "reviewId": "73748574902", "rating": 0, "comments": "I am a long time customer and love Dieici. I am there at least once a week. I have never been disappointed with any service. I love all the girls. The customer service is beyond a 10. I also love the new addition Wish to the salon! Wish is a woman's clothing boutique. What could be better...beauty and fashion all in one spot!!! Dieci keeps getting better and better!", "title": null, "reviewer": { "firstName": "Jennifer", "lastName": "Bennett", "nickName": "Jennifer Bennett", "thumbnailUrl": "http://d2xt3xymj142xp.cloudfront.net/reviewer/9a070cf98f014f5d9b06987dcc9c48fe.jpeg", "emailId": "[email protected]", "facebookId": null, "city": "Cedar Knolls", "state": " NJ" }, "reviewUrl": "https://app.thrivelocal.com/imp-flower-15229573096", "sourceType": "Direct Feedback", "inlineReplyEnabled": true, "reviewDate": "Jan 20, 2019", "response": "Thanks", "responseDate": "Feb 18, 2019", "featured": 0, "customerId": 7432167, "extraParams": { "key1": "value1", "key2": "value2", "key3": "value3" }, "assitedByUser": [ { "firstName": "Steve", "lastName": "M.", "emailId": "[email protected]", "phoneNum": "" }, { "firstName": "Smith", "lastName": "S.", "emailId": "[email protected]", "phoneNum": "" } ] } ]

Error Responses

JSON
{ "status": 401, "code": 1161, "message": "Invalid API key" }
JSON
{ "status": 401, "code": 1011, "message": "Business id is invalid" }
JSON
{ "status": "error", "message": "Missing required field(s): id, start_date, end_date" }
Aaron-Whittaker-1