---
title: "Fetch all interactions"
method: GET
path: "/locations/{locationId}/reviews"
tags: ["Reviews", "Interactions"]
---

# Fetch all interactions

`GET /locations/{locationId}/reviews`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/{locationId}/reviews`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/:locationId/reviews/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `locationId` string, required

## Query parameters

- `siteUrls` string[]
- `category` string[]
- `startDate` string, date
- `endDate` string, date
- `ratingFilters` integer[]
- `searchString` string
- `before` string
- `after` string
- `first` string
- `last` string

## Headers

- `Authorization` string, required

## Response `200`

Interactions retrieved successfully

- InteractionsResponse
  - `data` object
    - `interactions` object
      - `pageInfo` PageInfoV5
        - `hasNextPage` boolean: Indicates if there are more pages of results
        - `hasPreviousPage` boolean: Indicates if there are previous pages of results
        - `endCursor` string, nullable: Cursor for pagination
        - `total` integer, nullable: Total number of pages
      - `edges` InteractionEdgeV2[]
        - `node` InteractionV2
          - `id` string, uuid: Unique identifier for the interaction
          - `source` string: Source website of the interaction
          - `title` string, nullable: Title of the interaction
          - `content` string, nullable: Content of the interaction
          - `authorName` string: Name of the author
          - `authorAvatar` string, nullable: URL of author's avatar
          - `authorUrl` string, nullable: URL of author's profile
          - `rating` integer: Rating value (1-5)
          - `date` string, date-time: Date and time of the interaction
          - `permalink` string, nullable: Permanent URL to the interaction
          - `category` string: Category of the interaction
          - `type` string: Type of the interaction
          - `photoUrl` string, nullable: URL of attached photo
          - `photoThumbnailUrl` string, nullable: URL of photo thumbnail
          - `responded` boolean: Whether the interaction has been responded to
          - `notes` string, nullable: Additional notes
          - `responses` object[]: Array of responses
          - `canRespond` boolean: Whether responses are allowed
          - `totalResponses` integer: Total number of responses
        - `cursor` string: Cursor for pagination
      - `totalCount` integer: Total number of interactions matching the filters

## Other responses

- `400`: Bad Request - Invalid parameters
- `404`: Location not found

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)