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

# Find Tracked Source

> Search for tracked sources by username or name

Search for tracked sources within a specific platform using keywords that match their username or display name. This is useful for finding the internal ID or external ID of a source you are already tracking.

## Parameters

<ParamField path="source" type="string" required>
  The source type. Valid values: `x`, `discord`, `telegram`
</ParamField>

## Query Parameters

<ParamField query="query" type="string" required>
  The search keyword. This will match against the source's username and display
  name (case-insensitive).
</ParamField>

<ParamField query="page" type="number" default="1">
  The page number for pagination.
</ParamField>

<ParamField query="limit" type="number" default="20">
  The number of results per page. Maximum is 100.
</ParamField>

## Response

<ResponseField name="data" type="array">
  An array of matching tracked source objects, each containing id, externalId,
  username, name, and timestamps.
</ResponseField>

<ResponseField name="total" type="number">
  The total number of matching sources found.
</ResponseField>

<ResponseField name="page" type="number">
  The current page number.
</ResponseField>

<ResponseField name="limit" type="number">
  The number of results per page.
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://scrape.st/track/x/find?query=elon&limit=5" \
    -H "x-api-key: YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": [
      {
        "id": "src_123",
        "source": "X",
        "externalId": "44196397",
        "username": "elonmusk",
        "name": "Elon Musk",
        "createdAt": "2024-01-15T10:30:00.000Z",
        "updatedAt": "2024-04-02T15:45:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 5,
    "message": "Found 1 matching sources"
  }
  ```
</ResponseExample>