> ## Documentation Index
> Fetch the complete documentation index at: https://monid.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# monid discover

> Search for data endpoints using natural language.

Search for data endpoints using natural language.

## Usage

```bash theme={null}
monid discover -q <query> [--limit <limit>] [--json]
```

## Flags

| Flag                  | Type    | Required | Description                                   |
| --------------------- | ------- | -------- | --------------------------------------------- |
| `-q, --query <query>` | string  | Yes      | A short natural language search query         |
| `--limit <limit>`     | number  | No       | Maximum number of results (default 5, max 40) |
| `-j, --json`          | boolean | No       | Output raw JSON                               |

## Examples

```bash theme={null}
# Search for Twitter-related endpoints
monid discover -q "twitter posts"

# Search with a limit
monid discover -q "linkedin profiles" --limit 3

# Get raw JSON output
monid discover -q "amazon product reviews" --json
```

## Output

Returns a list of endpoints matching the query:

```text theme={null}
Provider   Endpoint                       Price         Description
apify      /apidojo/tweet-scraper         $0.003/call   Scrape tweets by search...
apify      /apidojo/twitter-user-scraper  $0.003/call   Scrape Twitter user pro...
```

With the `--json` flag, the full JSON response is printed:

```json theme={null}
{
  "results": [
    {
      "provider": "apify",
      "providerName": "Apify",
      "endpoint": "/apidojo/tweet-scraper",
      "description": "Scrape tweets by search terms, hashtags, or user handles",
      "score": 0.87,
      "tags": ["twitter", "social-media"],
      "scoreBreakdown": { "querierScore": 0.82 },
      "price": {
        "type": "PER_CALL",
        "amount": { "value": 0.003, "currency": "USD" }
      }
    }
  ],
  "query": "twitter posts",
  "count": 2
}
```

## Tips

* **Keep queries short and focused.** Noun phrases like `"twitter posts"` or `"amazon product prices"` work better than full sentences.
* **Break complex requests into smaller pieces.** If you need data from multiple sources, discover each separately.
* **The endpoint catalog grows continuously.** Always discover rather than assuming what's available.

## Next Steps

After discovering endpoints, use [`monid inspect`](/docs/cli/inspect) to see the full input schema before running.