# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-turkishexporter-com-tr-api-c6cb3b20/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-turkishexporter-com-tr-api-c6cb3b20/get_company_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/get_importer_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/list_databanks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/list_free_requests \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/search_exporters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-turkishexporter-com-tr-api-c6cb3b20/search_importers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country_code":"<string>","page":"<integer>","query":"<string>"}'
```