# Gulfood — 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 the complete Gulfood exhibitor directory, including exhibitor profiles, products, brands, press releases, and exhibition sectors. Filter by country, category, venue, or keyword to find exhibitors and retrieve detailed profiles with stand locations, contact information, and social media links.

**Category:** Business Directories | **Website:** [gulfood.com/](https://gulfood.com/) | **Docs:** [parse.bot/marketplace/fc9f5aaf-abb8-48f3-8277-67909a64d287/gulfood-com-api](https://parse.bot/marketplace/fc9f5aaf-abb8-48f3-8277-67909a64d287/gulfood-com-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/gulfood/`
**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

### Export all exhibitors

Compile a dataset of exhibitors including detailed info (description, website, social links) for each. Fetches the exhibitor list and then retrieves detail pages for each one up to the specified limit. Makes many sequential requests and may be slow for large limits.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of exhibitors to export with full details. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/gulfood/export-all-exhibitors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get brands list

Fetch brands represented at the event. Returns paginated results of 16 per page. The exhibitor field is typically null for brand entries. Offset advances in multiples of 16; manual paging via the offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset in multiples of 16. |
| `query` | string | No | Keyword search for brands. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/gulfood/get-brands-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>","query":"<string>"}'
```

### Get exhibitor detail

Get detailed information for a specific exhibitor including description, website, stand location, country, social media links, and logo. Requires the exhibitor slug from the list endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Exhibitor slug from get_exhibitor_list results (e.g. 'ats-food-llc'). |

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

### Get exhibitor list

Fetch the paginated list of exhibitors with optional filters. Returns 16 exhibitors per page. Supports filtering by first letter, country, category, venue, and keyword search. Offset advances in multiples of 16; manual paging via the offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category ID to filter by. |
| `country` | string | No | Country ID(s) to filter by (comma-separated string for multiple). |
| `letter` | string | No | Single letter (A-Z) to filter exhibitors by first letter of name. |
| `offset` | integer | No | Pagination offset in multiples of 16. |
| `query` | string | No | Keyword search query to filter exhibitors by name. |
| `venue` | string | No | Venue ID to filter by. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/gulfood/get-exhibitor-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","country":"<string>","letter":"<string>","offset":"<integer>","query":"<string>","venue":"<string>"}'
```

### Get key sectors

Get the list of 15 key exhibition sectors and their associated venues at Gulfood 2026. Returns static data; no parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/gulfood/get-key-sectors \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get press releases list

Fetch press releases from exhibitors. Returns paginated results of up to 16 per page. Supports broad keyword matching. Offset advances in multiples of 16; manual paging via the offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset in multiples of 16. |
| `query` | string | No | Keyword search for press releases. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/gulfood/get-press-releases-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>","query":"<string>"}'
```

### Get products list

Fetch products listed by exhibitors. Supports keyword search filtering and pagination in groups of 16. Offset advances in multiples of 16; manual paging via the offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset in multiples of 16. |
| `query` | string | No | Keyword search to filter products by name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/gulfood/get-products-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>","query":"<string>"}'
```

### Search exhibitors

Search for exhibitors by keyword. Returns paginated results of 16 per page. The upstream search performs broad matching and may return results beyond exact keyword matches. Offset advances in multiples of 16; manual paging via the offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset in multiples of 16. |
| `query` | string | Yes | Search keyword to find exhibitors. |

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

## Next steps

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