Skip to contentDevelopersPrezly website
Press contacts

Search Newsroom Contacts

Select newsroom press contacts using a JSON search request.

Personal token scopes: sites:read. Your account must also have access to the requested data. Authentication

Read the guide

POST
/newsrooms/{newsroom_id}/contacts/search

This is similar to List Newsroom Contacts, but allows to provide a query expression to filter contacts by.

Personal access tokens: sites:read. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length

Request Body

application/json
  1. body
search?string

Keyword search term

query?

A query object following our Prezly Query Language syntax.

Response Body

OK

application/json
  1. response
contacts?array<>
Example Request
curl -X POST 'https://api.prezly.com/v2/newsrooms/string/contacts/search' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response200
{  "contacts": [    {      "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",      "id": 0,      "name": "string",      "email": "user@example.com",      "phone": "string",      "mobile": "string",      "company": "string",      "description": "string",      "website": "http://example.com",      "twitter": "string",      "facebook": "http://example.com",      "avatar_image": {        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",        "version": 0,        "filename": "string",        "mime_type": "string",        "size": 0,        "original_width": 0,        "original_height": 0,        "effects": [          "string"        ]      },      "is_featured": true,      "display_locales": [        {          "code": "en",          "name": "string",          "direction": "ltr",          "language_code": "en",          "native_name": "string"        }      ]    }  ]}