---
title: "Directories"
method: GET
path: "/social-posts/directories"
tags: ["Social Posting"]
---

# Directories

`GET /social-posts/directories`

Get a list of directories where a posting is possible for the given combination of parameters.
The response also contains warnings like missing directory connections.

## Query parameters

- `locationIds` string[]
- `businessIds` string[]
- `locationGroupIds` string[]
- `labels` string[]
- `excludedLocationIds` string[]

## Response `200`

Directories retrieved

- object
  - `status` 'SUCCESS' | 'PENDING' | 'QUOTA_LIMIT_EXCEED' | 'NOT_AUTHORIZED' | 'FORBIDDEN' | 'BAD_ACCESS_TOKEN' | 'BAD_PRIVATE_KEY' | 'BAD_PUBLIC_KEY' | 'MISSING_PARAMETER' | 'INVALID_PARAMETER' | 'WRONG_PARAMETER_TYPE' | 'CONFLICT' | 'RESOURCE_LOCKED' | 'SERVER_ERROR' | 'ERROR' | 'NOT_FOUND' | 'BAD_REQUEST' | 'USER_ERROR' | 'PARTIAL_ERROR' | 'SERVICE_TEMPORARILY_UNAVAILABLE', required
  - `message` string — (optional) Holds further information about the response
  - `warnings` string[] — (optional) Holds further warnings
  - `response` object, required — Social Post Directories Response Model
    - `directories` string[] — List of directories that are eligible for a post
    - `totalLocationsCount` integer — Total amount of considered directories
    - `directoryWarnings` object[] — List of warnings for directories
      - `directory` string — Name of the directory that contains warnings
      - `warnings` object[] — List of warnings
        - `type` string — Type of the warning. For now, these are supported: Google only: MISSING_CONNECTION, MISSING_VERIFICATION, CAN_NOT_POST_ON_GOOGLE Facebook only: MISSING_CONNECTION Other directories and warnings for whole locations: NEEDS_REVIEW
        - `locationIds` integer[] — List of locationIds (out of the selected locations) with that warning
    - `locationWarnings` object[] — List of warnings for locations
      - `type` string — Type of the warning. For now, these are supported: Google only: MISSING_CONNECTION, MISSING_VERIFICATION, CAN_NOT_POST_ON_GOOGLE Facebook only: MISSING_CONNECTION Other directories and warnings for whole locations: NEEDS_REVIEW
      - `locationIds` integer[] — List of locationIds (out of the selected locations) with that warning
    - `googleAlertTypes` string[] — Currently active types for Google ALERT

## Other responses

- `400` — Bad Request - The request was invalid or cannot be otherwise served
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - The request is understood, but has been refused or access is not allowed
- `404` — Not Found - The requested resource could not be found

---

[API](https://skmtc.net/uberall/apis/uberall-api.md) · [All operations](https://skmtc.net/uberall/apis/uberall-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uberall/uberall-api/revisions/a506e82d7cbe/schema)