# Agencyspotter — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and discover agencies with detailed information including their locations, staff profiles, and client reviews. Find the right agency partner by browsing comprehensive directory listings and accessing insights into their team and reputation.

**Category:** Business Directories | **Website:** [agencyspotter.com/](https://agencyspotter.com/) | **Docs:** [parse.bot/marketplace/b4fcc015-3e33-4391-8a71-b8289d0058ce/agencyspotter-com-api](https://parse.bot/marketplace/b4fcc015-3e33-4391-8a71-b8289d0058ce/agencyspotter-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/agencyspotter/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get agency detail

Retrieve the full profile of a specific agency by its slug. Returns comprehensive information including staff LinkedIn profiles, client reviews with ratings, portfolio projects, services offered, social media links, location details, and aggregate stats. The slug is obtainable from search_agencies results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The unique slug of the agency, obtainable from search_agencies results (e.g. 'sociallyin', 'simpletiger') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/agencyspotter/get-agency-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Search agencies

Search the Agency Spotter directory for agencies by keyword and location. Returns a paginated list of agency summaries including name, slug, rating, and services. Results are ordered by relevance. Each page returns up to 30 agencies. Omitting all filters returns the full directory browsed alphabetically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location to filter results by (e.g. 'New York', 'Los Angeles') |
| `page` | integer | No | Page number for pagination |
| `query` | string | No | Agency name or keyword to search for (e.g. 'digital marketing', 'SEO') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/agencyspotter/search-agencies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.