Fiverr APIfiverr.com ↗
Search Fiverr gigs by keyword, budget, delivery time, and seller level. Fetch full gig details including package tiers, reviews, and seller profiles via two endpoints.
What is the Fiverr API?
The Fiverr API exposes two endpoints — search_gigs and get_gig_details — giving developers structured access to Fiverr's freelance marketplace. search_gigs returns up to 48 gig cards per page including title, seller level, starting price in USD, rating, review count, and thumbnail URL. get_gig_details retrieves a single gig's complete data: all package tiers with pricing and delivery days, seller bio and credentials, FAQ entries, gallery images, and recent reviews.
curl -X GET 'https://api.parse.bot/scraper/1d7f7367-2e25-4d53-9fc4-8c25b767e901/search_gigs?sort=price_asc&query=mascot+logo&pro_only=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Searches Fiverr gigs for a free-text query and returns one page of gig cards (up to 48 per page, the site's fixed page size) with title, seller name and level, rating, review count, starting price (USD, the cheapest package), gig URL and thumbnail. Optional filters narrow by starting-price range in whole USD (min_price/max_price), maximum delivery time in days, seller level (comma-separated list) and Pro-only sellers; sort defaults to relevance and, as on the site, orders the organic cards only: promoted (advertised) cards, flagged is_promoted, are placed first by the site regardless of sort. One request per call. Paging is caller-controlled through page (1-based; omitted = first page); total_results and has_more come from the site. Filter combinations that match nothing return an empty gigs list with total_results 0. applied_filters echoes the filters the site acknowledged.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based results page; each page holds up to 48 gigs. |
| sort | string | Result ordering of organic cards; auto is the site's relevance ranking. |
| queryrequired | string | Free-text search phrase, e.g. one shape: 'mascot logo'. |
| pro_only | boolean | true restricts results to Fiverr Pro (vetted) sellers. |
| max_price | integer | Maximum starting price in whole USD (inclusive). Omitted = no upper bound. Must be >= min_price when both are given. |
| min_price | integer | Minimum starting price in whole USD (inclusive). Omitted = no lower bound. |
| seller_level | string | Comma-separated list of seller level codes from the SellerLevel enum, e.g. top_rated_seller,level_two_seller. The scraper splits on commas — do NOT pass an array. Omitted = all levels. Values outside the enum are rejected. |
| delivery_time | string | Maximum delivery time of the gig's packages. Omitted = any delivery time. |
{
"type": "object",
"fields": {
"gigs": "array of gig cards: gig_id (integer), title, gig_url (full URL, accepted by get_gig_details), thumbnail, seller_username, seller_display_name, seller_url, seller_level (SellerLevel code), seller_country (ISO-2), seller_online, is_pro, is_promoted, rating (0-5 or null when unrated), reviews_count, starting_price (number, cheapest package), starting_price_delivery_days, currency (ISO code the prices are in), num_of_packages, offers_consultation",
"page": "1-based page returned",
"sort": "sort code in effect",
"query": "echo of the search phrase",
"has_more": "true when a further page exists",
"page_size": "gigs per page (48)",
"total_results": "total matching gigs reported by the site",
"applied_filters": "object of filters the site acknowledged (keys gig_price_range, delivery_time, seller_level, pro), empty when none"
},
"sample": {
"data": {
"gigs": [
{
"title": "I will design awesome mascot logo, cartoon, character",
"gig_id": 133025786,
"is_pro": false,
"rating": 4.9,
"gig_url": "https://www.fiverr.com/thefatboy/design-mascot-logo-for-youtube-twitch-esport-team-and-streamer",
"currency": "USD",
"thumbnail": "https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/133025786/original/23838fb49e65469bbbd5e0eb06c30f6d0eb261b6.jpg",
"seller_url": "https://www.fiverr.com/thefatboy",
"is_promoted": true,
"seller_level": "top_rated_seller",
"reviews_count": 1819,
"seller_online": false,
"seller_country": "ID",
"starting_price": 35,
"num_of_packages": 3,
"seller_username": "thefatboy",
"offers_consultation": false,
"seller_display_name": "Jane Doe",
"starting_price_delivery_days": 5
}
],
"page": 1,
"sort": "auto",
"query": "mascot logo",
"has_more": true,
"page_size": 48,
"total_results": 17234,
"applied_filters": {}
},
"status": "success"
}
}About the Fiverr API
Search Fiverr Gigs
The search_gigs endpoint accepts a query string (e.g. mascot logo) and returns one page of up to 48 gig cards. Each card includes gig_id, title, gig_url, thumbnail, seller_username, seller_level, rating, review_count, and starting_price_usd (the cheapest package tier). Pagination is controlled by the page parameter; has_more indicates whether additional pages exist and total_results gives the site-reported match count. The sort parameter controls ordering — the default is the site's own relevance ranking.
Filtering Results
Four optional filters narrow search_gigs results. min_price and max_price bound the starting price in whole USD — both are inclusive and min_price must not exceed max_price when both are supplied. delivery_time caps the maximum delivery duration across a gig's packages. seller_level accepts a comma-separated list of SellerLevel codes such as top_rated_seller or level_two_seller. pro_only restricts results to Fiverr Pro (vetted) sellers only. The applied_filters field in the response confirms which filters the site acknowledged.
Gig Detail Data
get_gig_details takes a gig_url — the value emitted by search_gigs in the form https://www.fiverr.com/<seller>/<gig-slug> — and returns the full gig record. Package tiers carry price (USD), delivery_days, revisions (integer or 'unlimited'), and included features. The seller object includes username, display_name, seller_level, country, bio, one_liner, rating, and ratings_count. Additional fields include gallery image URLs, tags, faq question-answer pairs, is_pro flag, and status.
The Fiverr API is a managed, monitored endpoint for fiverr.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fiverr.com 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 fiverr.com 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?+
- Build a freelancer comparison tool that surfaces gig starting prices, delivery times, and seller levels side by side using search_gigs filter parameters.
- Monitor price changes for specific logo or mascot design gigs over time by polling get_gig_details on a set of tracked gig_urls.
- Aggregate Fiverr Pro seller profiles by querying search_gigs with pro_only=true and extracting seller country, bio, and ratings_count.
- Generate a ranked shortlist of gigs within a client's budget by combining max_price and seller_level filters in search_gigs.
- Extract FAQ content and package inclusions from gig detail pages to feed a structured comparison database for a procurement workflow.
- Analyze review counts and average ratings across a category by paginating search_gigs results and recording the rating and review_count fields.
- Populate a curated directory of top-rated Fiverr sellers by filtering for top_rated_seller level and extracting seller display_name, country, and one_liner from get_gig_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.