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

# Parameters

> Complete reference for all search parameters — types, valid values, defaults, and constraints.

All parameters are passed as query string parameters on `GET /v1/search`.

## Parameter table

<ParamField query="query" type="string">
  Free-text keyword search. Matches against the influencer's name and bio.

  **Examples:** `"yoga teacher NYC"`, `"vegan chef"`, `"travel photographer"`

  At least one of `query` or `category` is required.
</ParamField>

<ParamField query="category" type="string">
  Business category to filter by. Only returns accounts with a matching Instagram business category.

  **Valid values:**

  | Category  | Category      | Category  |
  | --------- | ------------- | --------- |
  | Beauty    | Fitness       | Tech      |
  | Food      | Travel        | Fashion   |
  | Health    | Music         | Gaming    |
  | Art       | Photography   | Education |
  | Business  | Entertainment | Sports    |
  | Lifestyle | Automotive    | Finance   |

  At least one of `query` or `category` is required.
</ParamField>

<ParamField query="country" type="string">
  Two-letter country code. Filters by the influencer's detected location.

  **Valid values (common):**

  | Code | Country       | Code | Country        |
  | ---- | ------------- | ---- | -------------- |
  | US   | United States | UK   | United Kingdom |
  | DE   | Germany       | FR   | France         |
  | IT   | Italy         | ES   | Spain          |
  | CA   | Canada        | AU   | Australia      |
  | BR   | Brazil        | IN   | India          |
  | NL   | Netherlands   | SE   | Sweden         |
  | MX   | Mexico        | JP   | Japan          |
  | KR   | South Korea   | TR   | Turkey         |
  | RU   | Russia        | PL   | Poland         |
  | AE   | UAE           | SA   | Saudi Arabia   |

  Most ISO 3166-1 alpha-2 codes are supported.
</ParamField>

<ParamField query="gender" type="string">
  Gender filter. Uses face detection on profile photos.

  **Valid values:** `"male"`, `"female"`
</ParamField>

<ParamField query="min_followers" type="integer">
  Minimum follower count (inclusive).

  **Range:** 0 to 1,000,000,000

  **Default:** none (no minimum)
</ParamField>

<ParamField query="max_followers" type="integer">
  Maximum follower count (inclusive). Useful for finding micro-influencers.

  **Range:** 0 to 1,000,000,000

  **Default:** none (no maximum)
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of results to return.

  **Range:** 1 to 100

  **Default:** 20

  Affects pricing — see [Pricing](/docs/reference/pricing).
</ParamField>

## Combining filters

All filters can be combined. The API returns results matching **all** specified filters (AND logic).

```
GET /v1/search?category=Fitness&country=US&gender=female&min_followers=10000&max_followers=100000&limit=50
```

This returns up to 50 female fitness influencers in the US with 10K-100K followers.

## Requirements

* At least one of `query` or `category` must be provided
* If both are provided, `category` filters the results and `query` performs a keyword search within that category

## Notes

* Country codes are case-insensitive (`us` and `US` both work)
* Gender detection uses facial analysis on profile photos — accuracy may vary
* Results are sorted by follower count (descending)
* The `max_followers` filter enables micro-influencer discovery