TurkishExporter APIturkishexporter.com.tr ↗
Access Turkish import/export requests, company profiles, trade categories, and databanks via 8 endpoints from turkishexporter.com.tr.
What is the TurkishExporter API?
The TurkishExporter API exposes 8 endpoints covering import and export trade requests, company directory profiles, trade categories, databanks, and publicly visible free requests from turkishexporter.com.tr. The search_importers endpoint lets you filter import requests by keyword and country code, returning paginated arrays of request objects with id, title, country, date, and keywords. Companion endpoints cover exporter offers, company listings, and detailed profiles for individual trade requests and companies.
curl -X GET 'https://api.parse.bot/scraper/4b6e4f43-bb8f-4152-9a6a-d0c2967eed72/search_importers?page=1&query=machinery&country_code=bangladesh' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace turkishexporter-com-tr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: TurkishExporter SDK — bounded, re-runnable; every call capped."""
from parse_apis.turkishexporter_api import TurkishExporter, ResourceNotFound
client = TurkishExporter()
# Search for import requests related to machinery — cap at 5 results.
for lead in client.leadsummaries.search_imports(query="machinery", limit=5):
print(lead.title, lead.country)
# Drill into the first import request's full details.
lead = client.leadsummaries.search_imports(query="textile", limit=1).first()
if lead:
detail = lead.details()
print(detail.title, detail.description, detail.categories)
# Search Turkish export companies and get one company's full profile.
company = client.companysummaries.search(query="food", limit=1).first()
if company:
profile = company.details()
print(profile.name, profile.categories, profile.tags[:5])
# List trade categories and show top ones by listing count.
for cat in client.categories.list(limit=5):
print(cat.name, cat.count, cat.slug)
# Typed error handling: catch a not-found on a bad slug.
try:
bad = client.companysummary(slug="nonexistent-company-000000").details()
except ResourceNotFound as exc:
print(f"Company not found: {exc.slug}")
# List free trade requests.
for req in client.freerequests.list(count=10, limit=3):
print(req.title, req.region_name, req.lead_type)
print("exercised: leadsummaries.search_imports / details / companysummaries.search / details / categories.list / freerequests.list")
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.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| query | string | Search keyword to filter import requests (e.g. 'machinery', 'textile'). |
| country_code | string | Country slug for filtering results by country (e.g. 'bangladesh', 'pakistan', 'usa', 'france'). Uses lowercase country name as URL slug. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"type": "string, always 'imports'",
"items": "array of import request objects with id, title, url, slug, country, date, keywords, type"
},
"sample": {
"data": {
"page": 1,
"type": "imports",
"items": [
{
"id": "844214",
"url": "https://www.turkishexporter.com.tr/en/imports-exports/sri-lanka-corporation-purchases-earth-drilling-machine-844214/",
"date": "06-10-2026 11:52:00",
"slug": "sri-lanka-corporation-purchases-earth-drilling-machine-844214",
"type": "imports",
"title": "Sri Lanka corporation purchases Earth Drilling Machine",
"country": "Sri Lanka",
"keywords": [
"construction machinery",
"drilling machine",
"sri lanka"
]
}
]
},
"status": "success"
}
}About the TurkishExporter API
Trade Request Search and Detail
search_importers and search_exporters both accept optional query, country_code, and page parameters and return paginated items arrays. Each item includes an id, title, url, country, date, keywords, and a type field fixed to 'imports' or 'exports' respectively. For a full record, pass the URL slug to get_importer_detail, which returns title, description, country, categories, tags, and a similar_requests array. The contact_info_gated field on that endpoint is always true — contact details are behind a membership wall and are not exposed.
Company Directory
search_companies accepts query, country (as a slug like 'turkey'), and page, returning company objects with name, url, description, tags, and membership status. Fetching a specific company by slug via get_company_detail returns the full profile: name, country, description, categories, and up to 50 tags representing the company's product keywords.
Categories, Databanks, and Free Requests
list_categories requires no inputs and returns a data array of category objects, each carrying id, name, slug, langCode, count, and url. list_databanks similarly returns a data array of trade research entries with id, title, countryCode, and countryName. list_free_requests accepts an optional count parameter and returns the latest publicly accessible trade leads through the resultObject array, which includes id, title, countryCode, regionName, leadType, and freeUntilTime — useful for sampling live trade activity without membership.
The TurkishExporter API is a managed, monitored endpoint for turkishexporter.com.tr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when turkishexporter.com.tr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official turkishexporter.com.tr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor new import requests in a target country by polling
search_importerswith acountry_codefilter. - Build a trade lead digest by fetching
list_free_requestson a schedule and surfacing entries byleadTypeandregionName. - Enrich a B2B prospecting list by querying
search_companieswith product keywords and pulling full profiles viaget_company_detail. - Categorize trade activity by sector using
list_categoriesto mapslugandcountfields to industry segments. - Identify competing export offers in a product niche by searching
search_exporterswith a productquery. - Track regional trade research coverage by iterating
list_databanksand grouping results bycountryCodeandcountryName. - Surface similar trade requests for a given import listing using the
similar_requestsarray fromget_importer_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does turkishexporter.com.tr have an official developer API?+
Can I retrieve contact information for importers or exporters through this API?+
get_importer_detail endpoint includes a contact_info_gated field that is always true, meaning contact information requires a paid membership on the source site and is not returned by the API. The API covers trade request descriptions, categories, tags, country, and similar requests.Does `list_free_requests` return both import and export leads?+
resultObject array includes a leadType field that distinguishes between import and export leads, along with countryCode, regionName, and a freeUntilTime timestamp indicating how long the record remains publicly visible.Is historical trade request data available through the API?+
search_importers, search_exporters) support pagination via the page parameter and return date fields on each item, but the API does not expose a dedicated date-range filter for historical lookups. You can fork this API on Parse and revise it to add a date-range parameter if your use case requires filtering by posting period.Does the API expose company contact details such as email, phone, or address?+
get_company_detail covers name, country, description, categories, and product tags. You can fork the API on Parse and revise it to add contact fields if they become accessible on the source profile pages.