# apollo.people.contacts.search

Saved contacts in the account by keyword, stage or label

> Use the search for contacts endpoint to search for the contacts that have been added to your team's Apollo account.

Page: https://telipot.com/catalog/tasks/apollo.people.contacts.search · Markdown: https://telipot.com/catalog/tasks/apollo.people.contacts.search/md · JSON: https://telipot.com/catalog/tasks/apollo.people.contacts.search/json

| Field | Value |
| --- | --- |
| provider | [Apollo](https://telipot.com/catalog/providers/apollo) `apollo` |
| capability | [`people.contacts.search`](https://telipot.com/catalog/capabilities/people.contacts.search) |
| kind | data |
| tier | core |
| price | Free (Free from the tool) |
| identity | Your plan |
| auth | `api_key · in header as x-api-key` |
| scope | own_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.apollo.io/api/v1/contacts/search` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://docs.apollo.io/reference/search-for-contacts |

## Inspect first

No complete example input is recorded. Read the schema and field notes before building the call.

```bash
telipot inspect apollo.people.contacts.search
```

```bash
curl https://api.telipot.com/v1/tasks/apollo.people.contacts.search \
  -H "Authorization: Bearer $TELIPOT_TOKEN"
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `q_keywords` | body | string | no |  | Keywords over names, job titles, employers or company names, or email addresses. Examples: CEO; Sumware Software. |
| `contact_stage_ids` | body | array | no |  | Apollo IDs of contact stages; a contact matches any one. List contact stages returns the IDs. |
| `contact_label_ids` | body | array | no |  | Apollo IDs of labels; a contact matches any one. |
| `sort_by_field` | body | string | no | one of "contact_last_activity_date", "contact_email_last_opened_at", "contact_email_last_clicked_at", "contact_created_at", "contact_updated_at" | Sort field, most recent first. |
| `sort_ascending` | body | boolean | no | default false | Set true for ascending order; needs sort_by_field. |
| `per_page` | body | integer | no | 1 to 100 | Results per page, up to 100. |
| `page` | body | integer | no | 1 to 500 | Page to return, up to 500 pages of 100; use with per_page. |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "q_keywords": {
      "type": "string",
      "description": "Keywords over names, job titles, employers or company names, or email addresses. Examples: CEO; Sumware Software.",
      "examples": [
        "CEO"
      ]
    },
    "contact_stage_ids": {
      "type": "array",
      "description": "Apollo IDs of contact stages; a contact matches any one. List contact stages returns the IDs."
    },
    "contact_label_ids": {
      "type": "array",
      "description": "Apollo IDs of labels; a contact matches any one."
    },
    "sort_by_field": {
      "type": "string",
      "description": "Sort field, most recent first.",
      "enum": [
        "contact_last_activity_date",
        "contact_email_last_opened_at",
        "contact_email_last_clicked_at",
        "contact_created_at",
        "contact_updated_at"
      ]
    },
    "sort_ascending": {
      "type": "boolean",
      "description": "Set true for ascending order; needs sort_by_field.",
      "default": false
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page, up to 100.",
      "examples": [
        10
      ],
      "minimum": 1,
      "maximum": 100
    },
    "page": {
      "type": "integer",
      "description": "Page to return, up to 500 pages of 100; use with per_page.",
      "examples": [
        1
      ],
      "minimum": 1,
      "maximum": 500
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "contacts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "first_name": {
            "type": "string"
          },
          "last_name": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "email_status": {
            "type": "string"
          },
          "linkedin_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "organization_name": {
            "type": "string"
          },
          "organization_id": {
            "type": "string"
          },
          "account_id": {
            "type": "string"
          },
          "contact_stage_id": {
            "type": "string"
          },
          "owner_id": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "updated_at": {
            "type": "string"
          },
          "label_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "phone_numbers": {
            "type": "array"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "properties": {
        "page": {
          "type": "integer"
        },
        "per_page": {
          "type": "integer"
        },
        "total_entries": {
          "type": "integer"
        },
        "total_pages": {
          "type": "integer"
        }
      }
    }
  }
}
```