---
title: "Search marketing agencies"
method: GET
path: "/search"
---

# Search marketing agencies

`GET /search`

## Request

- Base URL: `https://www.pickanagency.com/api/v1`
- URL: `https://www.pickanagency.com/api/v1/search`
- Auth: none required
- TypeScript: <https://skmtc.dev/pickanagency/apis/pick-an-agency-api/docs/search/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `q` string
- `service` string
- `country` string
- `city` string
- `industry` string
- `min_rating` number
- `limit` integer

## Response `200`

Matching agencies

- object
  - `count` integer
  - `results` object[]
    - `slug` string
    - `name` string
    - `tagline` string, nullable
    - `location` object
      - `city` string, nullable
      - `country` string, nullable
    - `rating` number, nullable: Overall rating, 0-5
    - `total_reviews` integer
    - `services` string[]
    - `industries` string[]
    - `team_size` '1-10' | '11-50' | '51-200' | '201-500' | '500+' | 'null', nullable
    - `founded_year` integer, nullable
    - `min_budget_usd` integer, nullable
    - `website` string, nullable
    - `is_verified` boolean
    - `profile_url` string, uri
  - `meta` Meta: Attribution and docs pointers, present on every response
    - `source` string
    - `attribution` string
    - `docs` string, uri

## Other responses

- `400`: Invalid min_rating
- `500`: Search failed

## Changes

- **2026-09-14** `7d3d76fe54d2`: 3 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
  - added the optional property `meta` to the response with the `200` status

[Operation history](https://skmtc.dev/pickanagency/apis/pick-an-agency-api/changes/search/get.md)

---

[API](https://skmtc.dev/pickanagency/apis/pick-an-agency-api.md) - [All operations](https://skmtc.dev/pickanagency/apis/pick-an-agency-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pickanagency/apis/pick-an-agency-api/revisions/0c6a8f294ce8?raw)