# Turkishexporter — 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 and explore Turkish importers, exporters, and companies with detailed business profiles and trade requests to find potential trading partners. Browse available categories and databanks to discover new business opportunities in the Turkish trade market.

**Category:** Business Directories | **Website:** [turkishexporter.com.tr/](https://turkishexporter.com.tr/) | **Docs:** [parse.bot/marketplace/c6cb3b20-8015-4716-9aaa-e8cca3aa2787/turkishexporter-com-tr-api](https://parse.bot/marketplace/c6cb3b20-8015-4716-9aaa-e8cca3aa2787/turkishexporter-com-tr-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/turkishexporter/`
**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 company detail

Retrieve full profile details for a specific company including description, categories, and product tags. The slug is obtained from the slug field of search_companies results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the company, from search_companies results (e.g. 'gns-ihracat-ltd-sti-60655'). |

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

### Get importer detail

Retrieve full details for a specific import or export trade request including description, categories, tags, and similar requests. The slug parameter is obtained from the slug field of search_importers or search_exporters results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the trade request, from search_importers or search_exporters results (e.g. 'sri-lanka-corporation-purchases-earth-drilling-machine-844214'). |

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

### List categories

List popular trade categories from the Forie services API. Returns categories with IDs, names, slugs, and listing counts. No pagination — returns all popular categories in a single response.

**Estimated cost:** Metered

_No parameters required._

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

### List databanks

List latest databank posts from the Forie services API. Returns trade research entries with titles, country codes, and IDs. No pagination — returns all recent databank entries.

**Estimated cost:** Metered

_No parameters required._

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

### List free requests

List the latest free (publicly accessible) trade requests. Returns recent import and export requests that are temporarily publicly visible, including their lead type and free-until time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Number of requests to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/turkishexporter/list-free-requests \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>"}'
```

### Search companies

Search and list companies in the Turkish exporter directory with filters for keyword, country, and pagination. Each result includes a slug suitable for fetching full details via get_company_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country slug for filtering (e.g. 'turkey'). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter companies (e.g. 'textile', 'food'). |

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

### Search exporters

Search and list export trade requests (offers) with filters for keyword, country, and pagination. Returns paginated results from the exports section. Each result includes a slug suitable for fetching full details via get_importer_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Country slug for filtering results by country (e.g. 'turkey', 'pakistan', 'spain'). Uses lowercase country name as URL slug. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter export offers (e.g. 'textiles', 'food'). |

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

### Search importers

Search and list import trade requests (importers) with filters for keyword, country, and pagination. Returns paginated results from the imports section. Each result includes a slug suitable for fetching full details via get_importer_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_code` | string | No | Country slug for filtering results by country (e.g. 'bangladesh', 'pakistan', 'usa', 'france'). Uses lowercase country name as URL slug. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter import requests (e.g. 'machinery', 'textile'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/turkishexporter/search-importers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","page":"<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.