# Seccionamarilla — 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.

> Search for Mexican businesses and get their detailed contact information, hours, and locations from Sección Amarilla's comprehensive directory. Browse popular business categories to discover services and companies across Mexico.

**Category:** Business Directories | **Website:** [seccionamarilla.com.mx/](https://seccionamarilla.com.mx/) | **Docs:** [parse.bot/marketplace/6115e546-09a1-4239-8e01-1cb6eeba5546/seccionamarilla-com-mx-api](https://parse.bot/marketplace/6115e546-09a1-4239-8e01-1cb6eeba5546/seccionamarilla-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-seccionamarilla-com-mx-api-6115e546/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_business_details

Get detailed information for a specific business listing on Sección Amarilla, including phones, address, coordinates, operating hours, website, WhatsApp link, and social links. The URL parameter should be a full detail page URL obtained from search_businesses results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the business detail page on seccionamarilla.com.mx (e.g., from search_businesses results[*].url). |

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

### get_popular_categories

Get popular business categories from the Sección Amarilla homepage. Returns category display names and URL slugs that can be used as the query parameter in search_businesses.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seccionamarilla-com-mx-api-6115e546/get_popular_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_businesses

Search for business listings by keyword and location on Sección Amarilla. Returns paginated results with business name, address, phone, category, and detail URL. Each page returns up to 20 listings. Pagination is page-number based.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location to search in (e.g., 'ciudad de mexico', 'guadalajara', 'monterrey'). Omitting defaults to 'mexico'. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword or category (e.g., 'restaurantes', 'hoteles', 'dentistas'). Omitting defaults to 'restaurantes'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-seccionamarilla-com-mx-api-6115e546/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<string>"}'
```
