Fiverr API & Scraper
The Fiverr API returns live gig search, gig detail and public seller profiles as clean JSON, with no login.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary search endpoint returns gigs with id, title, slug and URL, the starting price (from, currency, delivery_days and package_count), rating and reviews_count, category and sub-category ids, gig images, Fiverr's own Pro and Fiverr's Choice flags, and the seller's username, display name, country_code, level, rating and ratings_count — promoted slots are left out by default, so what comes back is the organic result set. category browses a Fiverr category, gig expands one listing into its packages and delivery times, and seller returns a public profile. It is built for freelance-rate benchmarking, marketplace supply research and talent sourcing without running a scraper against Fiverr. One ReefAPI key, one shared credit pool, the standard envelope.
Seller level, package fields, and the same value in three different shapes
The three actions here read from three different Fiverr surfaces, so the same seller comes back with the same meaning in a different type depending on which one you called. If you are merging results, this table is the part that will bite you. Everything was read live on 2026-08-27 from search, gig and seller for the same seller and gig.
| Field | search returns | gig returns | seller returns |
|---|---|---|---|
| seller.level | "level_two_seller". Other values seen: "", "level_one_seller", "top_rated_seller" | 2 (an integer) | "LEVEL_TWO" |
| seller.id | 78762386 (a number) | "78762386" (a string) | "78762386" (a string) |
| languages[] | {code: "en", level: 3} | {code: "EN", level: "FLUENT"} | {code: "EN", level: "FLUENT"} |
| seller rating | 4.7543674, full precision | Not returned on the seller block | 4.9, rounded to one decimal |
| starting price | price.from 20 with currency USD | packages[0].price 20.0 with currency USD | price.from 20 on each gigs[] row |
| delivery | delivery_days 5, which is the Basic package | delivery_hours 120, 72 and 48 across the three packages | delivery_days null on gigs[] rows |
| revisions | Not returned | 5 on Basic, then -1 on both paid tiers | Not returned |
Basic, Standard and Premium are packages[].id 1, 2 and 3. The titles are whatever the seller typed, "Starter Pack -", "Pro Pack -" and "Elite Pack -" on the gig measured, so match on id and never on the title. revisions -1 means unlimited, not an error. Every review on the gig action came back with rating null, so take the score from reviews_summary.average; the reviews instead carry order_price_range as a band ("Up to $50", "$50-$100", "$100-$200"), order_duration_days and buyer_country. Paid promoted gigs are dropped by default, since Fiverr repeats the same ads at the top of every page; set include_promoted true to keep them, flagged is_promoted.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/fiverr/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "logo design",
"limit": 10
}
}{
"ok": true,
"meta": {
"api": "fiverr",
"endpoint": "search",
"mode": "live",
"latency_ms": 5083.6,
"record_count": 10,
"bytes": 2488405,
"cache_hit": false,
"method": "perseus_ssr_island_residential",
"stop_reason": "limit_reached",
"promoted_included": false
},
"data": {
"gigs": [
{
"id": 485339192,
"source": "fiverr",
"title": "design a premium modern minimalist custom logo for your business",
"slug": "do-modern-minimalist-custom-business-logo-design-and-branding",
"url": "https://www.fiverr.com/design1287/do-modern-minimalist-custom-business-logo-design-and-branding",
"is_promoted": false,
"is_pro": false,
"is_fiverr_choice": true,
"is_featured": false,
"offers_consultation": false,
"has_recurring_option": false,
"price": {
"from": 20,
"currency": "USD",
"delivery_days": 1,
"hourly_rate_cents": null,
"package_count": 3
},
"rating": 5,
"reviews_count": 23,
"category_id": 3,
"sub_category_id": 49,
"attributes": [
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"images": [
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/[redacted-phone]/original/13d48a1c1f[redacted-phone]e04af8cfbad8e4577b.jpeg",
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs2/[redacted-phone]/original/ce3bb45a654c784dc55c9ebf9eb3b6d3368a923a.jpeg",
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs3/[redacted-phone]/original/07dce9ed551a8dab11eecf31b1f610be947d52fd.jpeg"
],
"seller": {
"id": 221810619,
"username": "design1287",
"display_name": "Naseer Ahmad",
"country_code": "PK",
"level": "level_one_seller",
"is_online": false,
"rating": 5,
"ratings_count": 23,
"languages": [
"[trimmed-depth]"
],
"url": "https://www.fiverr.com/design1287"
}
},
{
"id": 119915917,
"source": "fiverr",
"title": "design professional and unique logo design for you",
"slug": "design-professional-and-unique-logo-design-for-you",
"url": "https://www.fiverr.com/ninedex/design-professional-and-unique-logo-design-for-you",
"is_promoted": false,
"is_pro": false,
"is_fiverr_choice": false,
"is_featured": false,
"offers_consultation": false,
"has_recurring_option": false,
"price": {
"from": 10,
"currency": "USD",
"delivery_days": 1,
"hourly_rate_cents": 2000,
"package_count": 3
},
"rating": 4.8,
"reviews_count": 2621,
"category_id": 3,
"sub_category_id": 49,
"attributes": [
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"images": [
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/[redacted-phone]/original/ade737279cfd05c2f7c0de95bf1b3dfdfeb7c1ed.jpg",
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs2/[redacted-phone]/original/4ac7d5896ba58ba77ce3a5e627b06a8bcba79dab.jpg",
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs3/[redacted-phone]/original/9d8b6cd2c30ca57efe1090caec4f2bb8ce0af3fc.jpg"
],
"seller": {
"id": 72194799,
"username": "ninedex",
"display_name": "Nine Designers",
"country_code": "PK",
"level": "level_two_seller",
"is_online": false,
"rating": 4.923077,
"ratings_count": 2625,
"languages": [
"[trimmed-depth]"
],
"url": "https://www.fiverr.com/ninedex"
}
},
{
"id": 146927460,
"source": "fiverr",
"title": "design extremely professional minimalist business logo design",
"slug": "design-5-modern-signature-logo",
"url": "https://www.fiverr.com/sumayya_designs/design-5-modern-signature-logo",
"is_promoted": false,
"is_pro": false,
"is_fiverr_choice": false,
"is_featured": false,
"offers_consultation": false,
"has_recurring_option": false,
"price": {
"from": 20,
"currency": "USD",
"delivery_days": 3,
"hourly_rate_cents": null,
"package_count": 3
},
"rating": 4.9,
"reviews_count": 218,
"category_id": 3,
"sub_category_id": 49,
"attributes": [
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"values": "[trimmed-depth]"
}
],
"images": [
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/[redacted-phone]/original/ce5174c87dae[redacted-phone]ab8dd4209e4fad.jpeg",
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs2/[redacted-phone]/original/2a4778c93dfbedefba672e7b97c34f65974ca285.jpeg",
"https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs3/[redacted-phone]/original/b6a1795d8e4220ec6125a643a165c046427da0ff.jpeg"
],
"seller": {
"id": 84611105,
"username": "sumayya_designs",
"display_name": "Sumayya D.",
"country_code": "PK",
"level": "level_two_seller",
"is_online": true,
"rating": 4.8660436,
"ratings_count": 348,
"languages": [
"[trimmed-depth]",
"[trimmed-depth]"
],
"url": "https://www.fiverr.com/sumayya_designs"
}
}
],
"total_count": 175020,
"returned": 10,
"offset": 0,
"query": "logo design",
"source": "fiverr"
}
}What the Fiverr API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search live Fiverr GIGS by keyword. Returns title, starting price + delivery days, package count, rating, review count, category, gig attributes (style/format/…), images, and the seller's handle, level, country, languages and rating. Paid 'promoted' gigs are dropped by default and flagged when kept. | Recruiting teams call search to search live Fiverr GIGS by keyword. | query, limit, offset, include_promoted |
| category | Browse a Fiverr CATEGORY without a keyword — same gig rows as `search`, taken from the category landing page. Use when you want the market for a whole sub-category (e.g. website development) rather than a search term. | Labor-market analysts call category to get browse a Fiverr CATEGORY without a keyword. | category, limit, offset, include_promoted |
| gig | Full detail for ONE Fiverr gig by URL or '<seller>/<slug>': description, every pricing package (title, price, delivery hours, revisions), FAQ, review summary and the most recent reviews with their order price band, plus the seller block. | Job boards call gig to get full detail for ONE Fiverr gig by URL or '<seller>/<slug>'. | id |
| seller | PUBLIC business profile of a Fiverr seller by handle or profile URL: display name, headline, bio, country, timezone, join date, languages, skills, seller level, Pro/verified flags, response time, hourly rate, rating, review count and the gigs they list. | Sales intelligence teams call seller to get pUBLIC business profile of a Fiverr seller by handle or profile URL. | username |
Call search from your stack
curl -X POST https://api.reefapi.com/fiverr/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"logo design","limit":10}'import requests
r = requests.post(
"https://api.reefapi.com/fiverr/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "logo design",
"limit": 10
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/fiverr/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "logo design",
"limit": 10
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.fiverr.search with {"query":"logo design","limit":10}.Who uses this API and why
- Rate-benchmarking tools call search to chart starting price and delivery time across a service category.
- Talent-sourcing platforms use seller to pull a freelancer's public level, country, rating and review count.
- Marketplace researchers use category to measure supply and the price distribution inside one Fiverr category.
- Competitive-intel tools use gig to compare a listing's package tiers and delivery times against their own.
Questions developers ask before integrating
What are the Fiverr seller level values?
Four, and one of them is an empty string. Across 48 gigs pulled for "python developer" on 2026-08-27, search returned level_two_seller on 30 sellers, level_one_seller on 7, top_rated_seller on 4, and "" on 7. The empty string is a seller who has not earned a level yet, not missing data, so do not treat it as null. Be aware that the same level arrives as the integer 2 on the gig action and as "LEVEL_TWO" on the seller action.
Does the API expose the Basic, Standard and Premium tiers?
Yes, on the gig action, as packages[]. A live read of one logo gig returned three packages with id 1, 2 and 3, price 20.0, 45.0 and 75.0 USD, delivery_hours 120, 72 and 48, and revisions 5, -1 and -1. Note the shape: id is the tier slot, the title is free text the seller wrote, and price rises as delivery_hours falls. search only shows you the cheapest tier, as price.from.
What does revisions -1 mean?
Unlimited revisions. It is Fiverr's sentinel for the "Unlimited" option in the package editor, and it appeared on both paid tiers of the measured gig while the Basic tier carried a real 5. Guard for it before you display or sort on the field, because a naive numeric sort will put the most generous packages last.
Is delivery time in days or hours?
Both, depending on the action. A search row gives price.delivery_days, an integer, which is the Basic package rounded up: 5 days for a gig whose Basic package is 120 hours. The gig action gives packages[].delivery_hours per tier, 120, 72 and 48 on the same gig. Hours are the precise figure. On the seller action's embedded gigs[] rows, delivery_days came back null altogether.
Why is the rating null on every review the gig action returns?
Fiverr does not publish a per-review star score on the gig page, only the text. All five reviews on the measured gig came back with rating null. The aggregate is right next to them: reviews_summary returned average 4.8 with total 2093 and has_more true. What the reviews do carry instead is unusual and useful, an order_price_range band such as "$100-$200", order_duration_days, and buyer_country.
Can I fetch a gig from its numeric id?
No. The gig action returns id 286340835 but will not accept it, because a Fiverr gig URL is /<seller-username>/<gig-slug> and the numeric id appears nowhere in the path. Pass either the full URL or "<seller>/<slug>". Both are on every search row as url and as slug plus seller.username, so carry one of them through your pipeline rather than the id.
How deep can I page through search results?
About 576 gigs per query. limit accepts 1 to 96 and offset accepts 0 to 480, so the deepest reachable row is 576, while a live search for "python developer" reported total_count 3677. Fiverr serves 48 per page, so asking for more than 48 walks extra pages for you. If you need the whole market, split the query by category or by keyword rather than trying to page past the offset ceiling.
What does the seller action add over the seller block on a search row?
The business profile. A live seller read added headline, country "Pakistan" with country_code PK, timezone "Asia/Karachi", joined_at as Unix epoch seconds (1563936663), response_time_hours 1, is_highly_responsive, is_agency, is_verified, is_on_vacation, hourly_rate with its currency (both null for this seller), reviews_count 3778 across all their work, and skills[] shaped {name, level, verified} with level "PRO". It also returns gigs[], every gig they list, each in the same shape as a search row.
What is the Fiverr API?
Fiverr API is a ReefAPI endpoint group for freelance gigs with starting prices, packages, delivery times and seller profiles. It returns live JSON through POST requests under /fiverr/v1.
Is the Fiverr API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Fiverr calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Fiverr login or account?
No login to Fiverr is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Fiverr data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Fiverr API use?
Fiverr actions currently cost 2-3 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Fiverr from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call fiverr actions with the same key, credit pool and JSON envelope used by normal REST requests.