# Paginasamarillas (Mexico) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.

> Access Mexico's largest business directory to find company profiles, browse business categories, search for specific services, and discover industry insights from curated blog content. Build applications that help users discover and learn about Mexican businesses all in one place.

**Category:** Business Directories | **Website:** [paginasamarillas.com.mx/](https://paginasamarillas.com.mx/) | **Docs:** [parse.bot/marketplace/60d08ab8-adc5-40d5-b1dd-988c03d78884/paginasamarillas-com-mx-api](https://parse.bot/marketplace/60d08ab8-adc5-40d5-b1dd-988c03d78884/paginasamarillas-com-mx-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_blog_post

Retrieves the full content of a specific blog post by its URL. Returns the post title and full text content. URLs come from list_blog_posts results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the blog post from list_blog_posts results (e.g. 'https://paginasamarillas.mx/blog/seguridad-privada/guia-servicios-seguridad-privada-mx-cdmx-edomex.html') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/get_blog_post \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_business_detail

Fetches the full profile of a business including contact information, services offered, reviews, and about text. Provide either a full profile URL, or both category and slug parameters. Profile URLs come from get_category or search_businesses results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug (e.g. 'seguridad-privada'). Must be used together with slug. |
| `slug` | string | No | Business slug (e.g. 'origins-private-security'). Must be used together with category. |
| `url` | string | No | Full profile URL of the business (e.g. 'https://paginasamarillas.mx/negocios/seguridad-privada/origins-private-security.html'). If provided, category and slug are extracted automatically. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/get_business_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","slug":"<string>","url":"<string>"}'
```

### get_category

Retrieves all business listings for a specific category by its slug. Returns the category display name and an array of businesses with names, ratings, review counts, descriptions, addresses, and profile URLs. The slug comes from list_categories results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Category slug from list_categories (e.g. 'seguridad-privada', 'entretenimiento', 'equipos-contra-incendios') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/get_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_homepage

Fetches homepage metadata including the page title, popular search tags, and featured business categories with their ratings and business counts. The featured categories rotate; the popular tags reflect trending searches.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/get_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_blog_posts

Lists all blog posts from the directory's blog section. Returns titles and URLs for each post. Posts cover industry topics like security, events, and technology.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/list_blog_posts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_categories

Lists all business categories including active ones with slugs and URLs, and upcoming categories not yet populated with listings. Active categories have a slug suitable for get_category; upcoming ones have only a name.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_businesses

Searches for businesses by matching the query against available category names and slugs. Returns businesses from all matching categories (up to 3 categories). The search is local — it matches against the category index, not a full-text index of business names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against category names (e.g. 'seguridad', 'entretenimiento', 'incendios') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-paginasamarillas-com-mx-api-60d08ab8/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```