# Willro Business API Details Source: https://developer.willro.com/docs/api-information The Willro Business API provides seamless access to reliable business data, customer reviews, and business-generated content. Willro functions much like Trustpilot, empowering businesses to integrate their reputation into third-party sites, apps, and services. Whether you’re building review widgets, business directories, or analytics tools, the Willro API delivers up-to-date information you can trust. *** ## Base URL All Willro API requests are made to this base URL: This API allows you to integrate business profiles, posts, and reviews into your apps and services.

**Base URL:**
`https://api.willro.com/api`

**Authentication Header:**
`x-api-key: willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030` *** ## Authentication All API requests require an API key sent in the request headers. Your API key identifies your application and grants access to Willro’s protected endpoints. ### How to Send Your API Key Include the following header in every request: ## Example Request Here’s how to make a simple request to fetch business information: ```js theme={null} const response = await fetch( 'https://api.willro.com/integration/business-api/info', { method: 'GET', headers: { 'x-api-key': 'willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030', 'Content-Type': 'application/json', }, } ); const data = await response.json(); console.log(data); ``` *** ## Available APIs Willro’s API is organized into several powerful endpoints: 📘 **Note:** All API endpoints return JSON responses and support RESTful operations. | API | Endpoint | Description | | -------------------- | ----------------------------------- | ------------------------------------------------------------ | | **Business Info** | `/integration/business-api/info` | Retrieve detailed profiles, contact info, and metadata. | | **Business Posts** | `/integration/business-api/posts` | Fetch updates, news, and announcements with pagination. | | **Customer Reviews** | `/integration/business-api/reviews` | Access customer reviews and ratings, with filters and pages. | *** # Get Business Information Source: https://developer.willro.com/docs/api-reference/business-info Retrieve comprehensive business details for Willro integrations Fetch detailed information about a business, including profile, contact details, and metadata. This endpoint returns all business details in a single response — no pagination required. *** ## Onboarding Guide This API is part of Willro's business integration suite. Use it to retrieve **profile**, **contact**, and **metadata** of your business in one call. ### Requirements * A valid **API key** (passed in the `x-api-key` header) * The endpoint must be accessed over HTTPS * Ensure your key is kept **confidential** and never exposed publicly ## Endpoint GET /integration/business-api/info **Base URL:** `https://api.willro.com` ## Authentication Your Willro API key. You can find it in your Willro dashboard under Developer > API Keys: > `willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030` *** ## Request Example ```javascript theme={null} const response = await fetch('https://api.willro.com/integration/business-api/info', { method: 'GET', headers: { 'x-api-key': 'willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030', 'Content-Type': 'application/json' } }); const data = await response.json(); console.log(data); ``` ## Response Example ```js theme={null} { "businessName": "ExampleCo", "website": "https://example.com", "category": "Retail", "averageRating": 3.2, "totalReview": 12, "googleMapUrl": null, "location": "London, UK", "ratingsBreakdown": [ { "count": 3, "rating": 5 }, { "count": 4, "rating": 4 } ] } ``` # Get Business Posts Source: https://developer.willro.com/docs/api-reference/business-posts Fetch paginated posts data for your business via the Willro API Retrieve posts or articles published by your business, with support for pagination. Use this endpoint to integrate business-related posts into your app, dashboard, or website. *** ## Onboarding Guide This API allows you to fetch business posts with optional pagination controls. ### Requirements * A valid **API key** passed in the `x-api-key` header * HTTPS requests only * Keep your API key safe and never expose it publicly *** ## Endpoint GET /integration/business-api/posts **Base URL:** `https://api.willro.com` *** ## Authentication Your Willro API key. You can find it in your Willro dashboard under Developer > API Keys: > `willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030` *** ## Query Parameters | Name | Type | Required | Description | | ----- | ------ | -------- | --------------------------------------- | | page | number | No | Page number for pagination (default: 1) | | limit | number | No | Number of posts per page (default: 10) | *** ## Request Example ```js theme={null} const page = 1; const limit = 10; const response = await fetch( `https://api.willro.com/integration/business-api/posts?page=${page}&limit=${limit}`, { method: 'GET', headers: { 'x-api-key': 'willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030', 'Content-Type': 'application/json', }, } ); const data = await response.json(); console.log(data); ``` ## Response Example ```js theme={null} { "links": { "self": "/api/integration/business-api/posts?expand=&limit=10&page=1&q=&sortBy=createdAt&sortType=DESC" }, "pagination": { "page": 1, "limit": 10, "totalItems": 0, "totalPages": 0 }, "data": [] } ``` # Get Business Reviews Source: https://developer.willro.com/docs/api-reference/business-reviews Retrieve paginated customer reviews for your business using the Willro API. Retrieve a paginated list of customer reviews for your business. Use this endpoint to display customer feedback and ratings in your dashboard or reports. *** ## Onboarding Guide This API lets you fetch reviews posted about your business. Results are paginated, so you can load reviews page by page. ### Requirements * A valid API key passed in the `x-api-key` header * HTTPS requests only * Keep your API key secure and private *** ## Endpoint GET /integration/business-api/reviews **Base URL:** `https://api.willro.com/api/v1` *** ## Authentication Your Willro API key. You can find it in your Willro dashboard under Developer > API Keys: > `willro_live_sk_95ad4a1e-48ac-4872-ae02-0d40072b60bf_6b7ec4b3af7911a65ee1c3a5ce3fe84b8c2e34136ca71030` *** ## Query Parameters | Name | Type | Required | Description | | --------- | ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | page | number | No | Page number for pagination (default: 1) | | limit | number | No | Number of reviews per page (default: 10) | | mediaType | string | No | Filter reviews by media type. One of: `IMAGE`, `TEXT`, `VIDEO`. | | sortType | string | No | Sort by relevance, rating, or recency. One of: `MOST_RELEVANT`, `HIGHEST_REVIEWS`, `LOWEST_REVIEWS`, `RECENT_REVIEWS`, `RECENT_WITH_MIN_ONE_REVIEW`. | | rating | number | No | Filter by rating value. Must be between `1` and `5`. | *** ## Request Example ```js theme={null} const page = 1; const limit = 10; const mediaType = 'TEXT'; const sortType = 'MOST_RELEVANT'; const rating = 3; const url = new URL('https://api.willro.com/api/v1/integration/business-api/reviews'); url.searchParams.set('page', String(page)); url.searchParams.set('limit', String(limit)); url.searchParams.set('mediaType', mediaType); url.searchParams.set('sortType', sortType); url.searchParams.set('rating', String(rating)); const response = await fetch(url.toString(), { method: 'GET', headers: { 'x-api-key': 'YOUR_API_KEY', 'Content-Type': 'application/json' } }); const data = await response.json(); console.log(data); ``` ## Response Example ```js theme={null} { "links": { "self": "/api/v1/integration/business-api/reviews?limit=10&page=1&rating=3&sortBy=createdAt&sortType=MOST_RELEVANT" }, "pagination": { "page": 1, "limit": 10, "totalItems": 5, "totalPages": 1 }, "data": [ { "author": { "name": "John Doe", "picture": "https://example.com/avatar.jpg", "username": "johndoe", "isVerified": true, "totalReview": 10 }, "business": { "businessName": "ExampleCo", "logo": "https://example.com/logo.png", "website": "https://example.com", "category": "Retail", "averageRating": 3.2, "totalReview": 12, "isVerified": true }, "rating": 3, "content": "Test review for engagement 1", "views": 6000, "layout": "CLASSIC", "publishedAt": "2025-12-07T04:00:14.761Z", "id": "6934fbc2f42d4678c9bd97a5", "reactions": 1, "topReactions": ["AGREE"], "comments": 50, "shares": 50, "location": "London, Uk", "media": { "url": "https://example.com/image1.jpg", "type": "IMAGE", "thumbnailUrl": "https://example.com/thumb1.jpg" } } ] } ``` # Get Business Information Source: https://developer.willro.com/docs/api-reference/endpoint/get-business-info GET /integration/business-api/info # Get Business Posts Source: https://developer.willro.com/docs/api-reference/endpoint/get-business-posts GET /integration/business-api/posts # Get Business Reviews Source: https://developer.willro.com/docs/api-reference/endpoint/get-business-reviews GET /integration/business-api/reviews # Errors Source: https://developer.willro.com/docs/errors/errors ## Error Handling **Cause**: Invalid or missing API key **Solution**: Verify your API key is correct and included in the `x-api-key` header. **Example Response:** ```json theme={null} { "code": 401, "message": "API key is required", "timestamp": "2025-07-09T15:08:09.106Z", "path": "/api/v1/integration/business-api/reviews?page=1&limit=10", "error": "Unauthorized" } ``` **Cause**: Requested page doesn't exist or no data available. **Solution**: Check pagination details in the response to avoid requesting non-existent pages or data. **Cause**: Rate limit exceeded. **Solution**: Implement exponential backoff and respect rate limit headers to avoid throttling. **Cause**: Unexpected server-side error occurred. **Solution**: Retry the request after some time. If the issue persists, contact support with request details. ## Next Steps Get business profile data Access customer Posts and ratings Access customer reviews and ratings Complete integration patterns # Introduction Source: https://developer.willro.com/docs/introduction Welcome to the Willro Business API - Your gateway to comprehensive business data # Welcome to Willro Business API The Willro Business API offers programmatic access to comprehensive business data, empowering businesses and developers to build modern integrations and deliver transparency to users. Willro.com functions as a platform similar to Trustpilot, enabling businesses to manage and display ratings and customer reviews across the web. By integrating with Willro, business owners can seamlessly showcase their reputation and customer sentiment on their websites, partner platforms, and digital services. Our API provides secure, reliable, and scalable access to: * **Business Profiles**\ Retrieve verified details about registered businesses, including names, contact details, industry categories, and locations. * **Business Posts**\ Access updates, news, and announcements shared by businesses. Use pagination to integrate this content dynamically into third-party apps or websites. * **Customer Reviews**\ Fetch customer feedback, ratings, and written reviews for businesses, enabling transparency and helping users make informed decisions. * **Real-Time Data**\ Integrate the most up-to-date business data into your systems, ensuring that your applications always reflect current information. Whether you’re building business dashboards, review widgets, analytics tools, or integrating ratings into e-commerce experiences, Willro’s API is designed to support your development efforts with robust and well-documented endpoints. ## What you can do Retrieve business profiles, contact details, and essential metadata, including industry classification and online presence links. Perfect for directory listings, business intelligence platforms, and CRM integrations. Access updates, announcements, and business content with support for pagination. Integrate business news into websites, apps, or partner portals. Fetch customer reviews and ratings with filtering options. Ideal for reputation management tools, marketing dashboards, and public-facing review widgets. Work with up-to-date business information through our stable API endpoints. Keep your applications current with the latest business insights. ## Getting started Create a Willro account and generate your API key from the developer dashboard. Your API key identifies your application and allows access to our secure endpoints. Use the business info endpoint to retrieve business details and test your API integration. Start with a simple GET request and explore the data you can access. Try the posts and reviews endpoints with pagination and filtering options. Combine multiple endpoints to build rich user experiences or internal tools. ## API Overview All Willro API requests: * Are made over HTTPS to ensure secure data transmission * Return data in JSON format for easy integration with modern tech stacks * Require an API key sent in the request headers to authenticate your requests ### Base URL [https://api.willro.com](https://api.willro.com) ## API Use Cases Here are a few examples of how you can leverage Willro’s API: * **Embed Ratings on Websites**\ Display business ratings and reviews directly on a business website, e-commerce store, or landing page. * **Monitor Customer Feedback**\ Build dashboards that track customer sentiment over time, helping businesses improve their products and services. * **Enrich Business Listings**\ Integrate detailed business information and reputation metrics into third-party platforms like directories, CRM systems, or B2B marketplaces. * **Competitive Analysis**\ Analyze reviews and ratings across competitors in a particular industry or region. Your API key grants access to your account’s allowed endpoints and quotas. Keep it secure and do not expose it publicly in client-side applications. *** Let’s start building powerful integrations together with Willro’s comprehensive business data APIs!