malt.fr APImalt.fr ↗
Search Malt.fr freelancer profiles, retrieve detailed profile data, and get autocomplete suggestions via 3 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/f4ca74ee-b27a-4850-8f6d-9c37af345224/search_freelancers?query=data+scientist&location=Paris' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for freelancers by keyword/expertise. Returns up to 24 profiles from the first page of results with name, headline, skills, pricing, location, ratings, and availability.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query (e.g., 'developpeur frontend', 'designer graphique', 'data scientist') |
| location | string | Location filter (e.g., 'Paris', 'Lyon') |
{
"type": "object",
"fields": {
"query": "string - the search query submitted",
"profiles": "array of profile objects with id, first_name, headline, profile_url, photo_url, location, price, availability, stats, badges, skills",
"search_id": "string - unique identifier for this search",
"pagination": "object with current_page, total_pages, total_elements, first_item, last_item",
"search_type": "string - search scope type (e.g. HOST_COUNTRY_REMOTE)"
},
"sample": {
"data": {
"query": "data scientist",
"profiles": [
{
"id": "5b073d15db554c66770f5e42",
"price": {
"amount": 500,
"currency": "EUR",
"formatted": "500 €",
"visibility": "VISIBLE"
},
"stats": {
"rating": 5,
"missions_count": 1,
"recommendations_count": 2
},
"badges": [],
"skills": [
{
"label": "TensorFlow",
"certified": false
},
{
"label": "Pytorch",
"certified": false
},
{
"label": "Data visualisation",
"certified": false
}
],
"headline": "💻 Data Scientist",
"location": {
"city": "Paris",
"type": "EVERYWHERE",
"country": "France",
"country_code": "FR"
},
"photo_url": "https://dam.malt.com/5456a1c4-ff22-4cce-b0f4-a469e69ef08c",
"first_name": "Romain",
"profile_url": "https://www.malt.fr/profile/romainjaminet",
"availability": {
"status": "AVAILABLE_AND_VERIFIED",
"frequency": "FULL_TIME"
}
}
],
"search_id": "6a0720c9a2d14c5ff8ca1b02",
"pagination": {
"last_item": 24,
"first_item": 1,
"total_pages": 25,
"current_page": 1,
"total_elements": 600
},
"search_type": "HOST_COUNTRY_REMOTE"
},
"status": "success"
}
}About the malt.fr API
The Malt.fr API gives developers structured access to freelancer data across 3 endpoints covering search, profile detail, and autocomplete. search_freelancers returns up to 24 profiles per page with fields like pricing, skills, location, availability, ratings, and badges. get_profile retrieves a single freelancer's full profile including languages spoken, experience headline, and badge tier. autocomplete helps surface relevant specialty terms from a partial query string.
Searching Freelancers
The search_freelancers endpoint accepts a query string (e.g., developpeur frontend, data scientist) and an optional location filter (e.g., Paris, Lyon). Each call returns up to 24 profile objects from the first results page. Profile objects include id, first_name, headline, profile_url, photo_url, location, price, availability, stats, badges, and skills. The response also includes a search_id, a search_type field indicating scope (such as HOST_COUNTRY_REMOTE), and a pagination object with current_page, total_pages, total_elements, first_item, and last_item.
Detailed Profile Lookup
The get_profile endpoint takes a username exactly as it appears in the Malt.fr profile URL. It returns a richer view of a single freelancer: full_name, headline, skills array, languages (each with name and level), location (city, country, country_code), price (amount, currency, and a hidden boolean), rating out of 5, and a badge string indicating tier (e.g., SUPER_MALTER_L3, SUPER_MALTER_L2).
Autocomplete Suggestions
The autocomplete endpoint accepts a short query prefix such as dev, design, or data and returns up to 15 suggestion strings covering freelancer specialties and skill terms. This is useful for building type-ahead search inputs or normalizing query terms before passing them to search_freelancers.
- Build a freelancer discovery tool filtered by skill and city using
search_freelancerswithqueryandlocationparams - Aggregate pricing data across freelancer profiles to benchmark typical day rates by specialty
- Identify top-rated Malt freelancers by parsing
ratingandbadgefields fromget_profile - Power a type-ahead search component using the
autocompleteendpoint to normalize user input - Monitor a freelancer's availability status and pricing over time via periodic
get_profilecalls - Compare skill sets across multiple profiles by collecting the
skillsarray from search results - Build a language-filtered freelancer shortlist using the
languagesfield returned byget_profile
| 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 | 250 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 Malt.fr offer an official developer API?+
What does `search_freelancers` return beyond basic name and title?+
price, availability, location, stats, badges, and a skills array alongside the freelancer's headline and profile_url. The response-level pagination object tells you total_pages and total_elements so you know the scope of results, and search_type indicates whether the search covers the host country, remote, or another scope.Does `get_profile` return a freelancer's work history or project portfolio?+
get_profile covers identity fields, skills, languages, location, price, rating, and badge tier. Work history and portfolio items are not exposed. You can fork the API on Parse and revise it to add an endpoint targeting that profile section.How does pagination work with `search_freelancers`?+
pagination object containing current_page, total_pages, total_elements, first_item, and last_item. Paginating through subsequent pages is not currently supported by this endpoint. You can fork the API on Parse and revise it to accept a page parameter and return additional result pages.Can I filter search results by price range or availability status?+
search_freelancers endpoint currently accepts only query and location as input parameters. Price and availability data are present in the response fields but cannot be used as pre-query filters through this API. You can fork the API on Parse and revise it to pass additional filter parameters to the endpoint.