---
title: "Find the capability that does something, by plain words in English or Chinese. Free, needs no key."
method: POST
path: "/find"
---

# Find the capability that does something, by plain words in English or Chinese. Free, needs no key.

`POST /find`

## Request

- Base URL: `https://api.socialtoai.com/v1`
- URL: `https://api.socialtoai.com/v1/find`
- Auth: none required

## Request body

- object
  - `query` string, required
  - `platform` 'bilibili' | 'douyin' | 'facebook' | 'google' | 'instagram' | 'kuaishou' | 'linkedin' | 'meta' | 'pinterest' | 'reddit' | 'telegram' | 'threads' | 'tiktok' | 'wechat' | 'wechat_channels' | 'weibo' | 'x' | 'xiaohongshu' | 'youtube' | 'zhihu'
  - `limit` integer

## Response `200`

The capabilities that match, best first.

- FindResponse
  - `request_id` string, required
  - `schema_version` 'v1', required
  - `query` string, required
  - `results` Capability[], required
    - `platform` string, required
    - `action` 'search' | 'trending' | 'detail' | 'comments' | 'user_profile' | 'user_posts' | 'call', required
    - `op` string
    - `selected_by` object
      - `param` string, required
      - `value` string
    - `name` object, required
      - `en` string, required
      - `zh` string, required
    - `summary` object, required
      - `en` string, required
      - `zh` string, required
    - `price_key` string, required
    - `credits` integer, required
    - `status` 'available' | 'paused', required
    - `pause_reason` 'operations' | 'quality' | 'price' | 'source' | 'outage'
    - `object_type` 'content' | 'account' | 'comment' | 'entry', required
    - `entry_type` string
    - `page_size` integer, nullable, required
    - `params` object[], required
      - `name` string, required
      - `type` string, required
      - `required` boolean, required
      - `one_of` boolean, required
      - `values` string[]
      - `default` string
      - `description` object, required
        - `en` string, required
        - `zh` string, required
    - `unavailable` string[], required
    - `last_tested_on` string, date, nullable, required
    - `example_call` object
      - `method` 'GET' | 'POST', required
      - `path` string, required
      - `body` object

## Other responses

- `400`: invalid_params
- `401`: unauthorized
- `429`: rate_limited
- `500`: internal_error

---

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