# Fetch all interactions

```http
GET https://api.synup.com/api/v4/locations/{locationId}/reviews
```

This API retrieves interactions for a specific location, supporting multiple filters to refine results.

 **Filtering Options:**
- Date Range – Fetch interactions within a specified time frame.
- Interaction Type – Filter by reviews, social engagements, or directory interactions.
- Platform – Retrieve interactions from specific sources (e.g., Google, Facebook, Yelp).
- Response Status – Show only responded or unresponded interactions.
- Rating – Filter reviews by star ratings (if applicable).
 - Keyword – Filter reviews whose content matches a search keyword.

Source: https://developer.synup.com/api/reviews/fetch-all-interactions

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `locationId` | string | required | Base64 encoded location ID |

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `siteUrls` | array | optional | Filter by source websites |
| `category` | array | optional | Filter by interaction category |
| `startDate` | string | optional | Start date for filtering (YYYY-MM-DD) |
| `endDate` | string | optional | End date for filtering (YYYY-MM-DD) |
| `ratingFilters` | array | optional | Filter by rating (1-5). Pass multiple values as an array. Example: [3,4] |
| `searchString` | string | optional | Filter interactions by keyword. Returns only interactions whose content matches the keyword. Example: pizza |
| `before` | string | optional | If specified, records after the cursor are returned |
| `after` | string | optional | If specified, records before the cursor are returned |
| `first` | string | optional | Specifies the number of records to fetch from the beginning |
| `last` | string | optional | Specifies the number of records to fetch from the end |

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/locations/:locationId/reviews' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Interactions retrieved successfully |
| `400` | Bad Request - Invalid parameters |
| `404` | Location not found |