Piloterr Fiverr API
The Fiverr API from Piloterr — 2 operation(s) for fiverr.
The Fiverr API from Piloterr — 2 operation(s) for fiverr.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/piloterr-com:piloterr-com-fiverr-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Piloterr API Reference Fiverr API
description: Complete API reference documentation.
version: 1.0.0
servers:
- url: https://api.piloterr.com
description: API Server
tags:
- name: Fiverr
paths:
/v2/fiverr/search:
get:
summary: Fiverr Search
description: 'Search Fiverr gigs using a direct search URL and receive paginated listings with seller information, gig titles, images, and seller levels.
**Credit cost:** 1 credit per call'
operationId: get-fiverr-search
security:
- ApiKeyAuth: []
parameters:
- name: query
in: query
required: true
description: "A Fiverr search URL for gigs.\n\n**Example:**\n\n https://www.fiverr.com/search/gigs?query=website+development\n\nThe API returns paginated gig listings including seller information, images, gig URLs, and seller levels.\n\n**Notes:**\n- Use a valid Fiverr gig search URL (starting with `https://www.fiverr.com/search/gigs?query=`)\n- You can append additional Fiverr filters to the URL (e.g. `&filter=rating`, `&delivery_time=1`) before submitting."
schema:
type: string
description: "A Fiverr search URL for gigs.\n\n**Example:**\n\n https://www.fiverr.com/search/gigs?query=website+development\n\nThe API returns paginated gig listings including seller information, images, gig URLs, and seller levels.\n\n**Notes:**\n- Use a valid Fiverr gig search URL (starting with `https://www.fiverr.com/search/gigs?query=`)\n- You can append additional Fiverr filters to the URL (e.g. `&filter=rating`, `&delivery_time=1`) before submitting."
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
id:
type: integer
type:
type: string
title:
type: string
images:
type: array
items:
type: string
gig_url:
type: string
position:
type: integer
seller_id:
type: integer
seller_name:
type: string
seller_image:
type: string
seller_level:
type: string
pagination:
type: object
properties:
next:
type: integer
total:
type: integer
current:
type: integer
other_pages:
type: array
items:
type: integer
total_pages:
type: integer
has_next_page:
type: boolean
examples:
Search for website development gigs:
value:
results:
- id: 396045309
type: promoted_gigs
title: build a wordpress website with unlimited revisions
images:
- https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/396045309/original/67ef8fbbbc1e8e64581059c07b4bf314ebd9f88f.png
gig_url: https://www.fiverr.com/baptiste_le_b/build-a-wordpress-website-with-unlimited-revisions
position: 0
seller_id: 183755788
seller_name: baptiste_le_b
seller_image: https://fiverr-res.cloudinary.com/t_profile_thumb,q_auto,f_auto/attachments/profile/photo/a766b04276bcb7460b1154fa16a9c02c-1837557881743234687.314392/16FFDDA9-C673-44AC-8563-F95713D92A1E
seller_level: level_one_seller
- id: 309994815
type: fiverr_choice
title: do wordpress website development, design or redesign wordpress blog
images:
- https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/309994815/original/ff1b400db41b15ae7628eb28b8729d0eb83e0eb6.png
gig_url: https://www.fiverr.com/woow_web/design-woocommerce-website-wordpress-ecommerce-website-or-online-store
position: 4
seller_id: 136598296
seller_name: woow_web
seller_image: https://fiverr-res.cloudinary.com/t_profile_thumb,q_auto,f_auto/attachments/profile/photo/55e0d23f56c7d328f88611e7a5a03930-1722231743932/2b7efd68-95ec-40e3-b8a8-1a2b4e7eac26.png
seller_level: level_two_seller
pagination:
next: 2
total: 52533
current: 1
other_pages:
- 2
- 3
- 4
- 5
total_pages: 1095
has_next_page: true
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Fiverr
post:
summary: Fiverr Search
description: 'Search Fiverr gigs using a direct search URL and receive paginated listings with seller information, gig titles, images, and seller levels.
**Credit cost:** 1 credit per call'
operationId: post-fiverr-search
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: "A Fiverr search URL for gigs.\n\n**Example:**\n\n https://www.fiverr.com/search/gigs?query=website+development\n\nThe API returns paginated gig listings including seller information, images, gig URLs, and seller levels.\n\n**Notes:**\n- Use a valid Fiverr gig search URL (starting with `https://www.fiverr.com/search/gigs?query=`)\n- You can append additional Fiverr filters to the URL (e.g. `&filter=rating`, `&delivery_time=1`) before submitting."
required:
- query
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
id:
type: integer
type:
type: string
title:
type: string
images:
type: array
items:
type: string
gig_url:
type: string
position:
type: integer
seller_id:
type: integer
seller_name:
type: string
seller_image:
type: string
seller_level:
type: string
pagination:
type: object
properties:
next:
type: integer
total:
type: integer
current:
type: integer
other_pages:
type: array
items:
type: integer
total_pages:
type: integer
has_next_page:
type: boolean
examples:
Search for website development gigs:
value:
results:
- id: 396045309
type: promoted_gigs
title: build a wordpress website with unlimited revisions
images:
- https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/396045309/original/67ef8fbbbc1e8e64581059c07b4bf314ebd9f88f.png
gig_url: https://www.fiverr.com/baptiste_le_b/build-a-wordpress-website-with-unlimited-revisions
position: 0
seller_id: 183755788
seller_name: baptiste_le_b
seller_image: https://fiverr-res.cloudinary.com/t_profile_thumb,q_auto,f_auto/attachments/profile/photo/a766b04276bcb7460b1154fa16a9c02c-1837557881743234687.314392/16FFDDA9-C673-44AC-8563-F95713D92A1E
seller_level: level_one_seller
- id: 309994815
type: fiverr_choice
title: do wordpress website development, design or redesign wordpress blog
images:
- https://fiverr-res.cloudinary.com/t_main1,q_auto,f_auto/gigs/309994815/original/ff1b400db41b15ae7628eb28b8729d0eb83e0eb6.png
gig_url: https://www.fiverr.com/woow_web/design-woocommerce-website-wordpress-ecommerce-website-or-online-store
position: 4
seller_id: 136598296
seller_name: woow_web
seller_image: https://fiverr-res.cloudinary.com/t_profile_thumb,q_auto,f_auto/attachments/profile/photo/55e0d23f56c7d328f88611e7a5a03930-1722231743932/2b7efd68-95ec-40e3-b8a8-1a2b4e7eac26.png
seller_level: level_two_seller
pagination:
next: 2
total: 52533
current: 1
other_pages:
- 2
- 3
- 4
- 5
total_pages: 1095
has_next_page: true
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Fiverr
/v2/fiverr/profile/info:
get:
summary: Fiverr Profile Info
description: 'Extract complete public profile data from any Fiverr seller, including gigs, ratings, reviews, skills, portfolio, and consultation pricing.
**Credit cost:** 1 credit per call'
operationId: get-fiverr-profile-info
security:
- ApiKeyAuth: []
parameters:
- name: query
in: query
required: true
description: "Fiverr profile URL of the seller you want to extract information from.\n\n**Example:**\n\n https://www.fiverr.com/example-user\n\nThe API returns the seller's full public profile including their bio, gigs, ratings, reviews, skills, portfolio, and consultation pricing.\n\n**Note:** Only publicly visible seller profiles are supported. The username alone (e.g. `example-user`) without the full URL is not accepted."
schema:
type: string
description: "Fiverr profile URL of the seller you want to extract information from.\n\n**Example:**\n\n https://www.fiverr.com/example-user\n\nThe API returns the seller's full public profile including their bio, gigs, ratings, reviews, skills, portfolio, and consultation pricing.\n\n**Note:** Only publicly visible seller profiles are supported. The username alone (e.g. `example-user`) without the full URL is not accepted."
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
user:
type: object
properties:
id:
type: string
name:
type: string
address:
type: object
properties:
country_code:
type: string
country_name:
type: string
profile:
type: object
properties:
display_name:
type: string
joined_at:
type: integer
languages:
type: array
items:
type: object
properties:
code:
type: string
level:
type: string
profile_image_url:
type: string
is_activation_completed:
type: boolean
is_pro:
type: boolean
rating:
type: object
properties:
count:
type: integer
score:
type: integer
gigs_data:
type: array
items:
type: object
properties:
title:
type: string
gig_id:
type: integer
is_pro:
type: boolean
status:
type: string
price_i:
type: integer
seller_level:
type: string
seller_rating:
type: object
properties:
count:
type: integer
score:
type: number
is_active:
type: boolean
description:
type: string
hourly_rate:
type: object
properties:
price_in_cents:
type: integer
seller_level:
type: string
response_time:
type: object
properties:
in_hours:
type: integer
is_on_vacation:
type: boolean
one_liner_title:
type: string
achievement_level:
type: string
approved_gigs_count:
type: integer
examples:
Fetch profile for example-user:
value:
user:
id: '84160294'
name: Alex Martin
address:
country_code: IT
country_name: Italy
profile:
display_name: Alex Martin
joined_at: 1581077239
languages:
- code: EN
level: FLUENT
- code: DE
level: FLUENT
- code: IT
level: FLUENT
profile_image_url: https://fiverr-res.cloudinary.com/placeholder/example-user.jpg
is_activation_completed: true
is_pro: true
rating:
count: 113
score: 5
gigs_data:
- title: shoot studio and lifestyle product photography for website, instagram and amazon
gig_id: 149055883
is_pro: true
status: APPROVED
price_i: 500
seller_level: top_rated_seller
seller_rating:
count: 113
score: 4.990741
is_active: true
description: Example seller profile.
hourly_rate:
price_in_cents: 25000
seller_level: LEVEL_TRS
response_time:
in_hours: 3
is_on_vacation: false
one_liner_title: Commercial Product Photography and Video
achievement_level: TOP_RATED_SELLER
approved_gigs_count: 3
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Fiverr
post:
summary: Fiverr Profile Info
description: 'Extract complete public profile data from any Fiverr seller, including gigs, ratings, reviews, skills, portfolio, and consultation pricing.
**Credit cost:** 1 credit per call'
operationId: post-fiverr-profile-info
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: "Fiverr profile URL of the seller you want to extract information from.\n\n**Example:**\n\n https://www.fiverr.com/example-user\n\nThe API returns the seller's full public profile including their bio, gigs, ratings, reviews, skills, portfolio, and consultation pricing.\n\n**Note:** Only publicly visible seller profiles are supported. The username alone (e.g. `example-user`) without the full URL is not accepted."
required:
- query
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
user:
type: object
properties:
id:
type: string
name:
type: string
address:
type: object
properties:
country_code:
type: string
country_name:
type: string
profile:
type: object
properties:
display_name:
type: string
joined_at:
type: integer
languages:
type: array
items:
type: object
properties:
code:
type: string
level:
type: string
profile_image_url:
type: string
is_activation_completed:
type: boolean
is_pro:
type: boolean
rating:
type: object
properties:
count:
type: integer
score:
type: integer
gigs_data:
type: array
items:
type: object
properties:
title:
type: string
gig_id:
type: integer
is_pro:
type: boolean
status:
type: string
price_i:
type: integer
seller_level:
type: string
seller_rating:
type: object
properties:
count:
type: integer
score:
type: number
is_active:
type: boolean
description:
type: string
hourly_rate:
type: object
properties:
price_in_cents:
type: integer
seller_level:
type: string
response_time:
type: object
properties:
in_hours:
type: integer
is_on_vacation:
type: boolean
one_liner_title:
type: string
achievement_level:
type: string
approved_gigs_count:
type: integer
examples:
Fetch profile for example-user:
value:
user:
id: '84160294'
name: Alex Martin
address:
country_code: IT
country_name: Italy
profile:
display_name: Alex Martin
joined_at: 1581077239
languages:
- code: EN
level: FLUENT
- code: DE
level: FLUENT
- code: IT
level: FLUENT
profile_image_url: https://fiverr-res.cloudinary.com/placeholder/example-user.jpg
is_activation_completed: true
is_pro: true
rating:
count: 113
score: 5
gigs_data:
- title: shoot studio and lifestyle product photography for website, instagram and amazon
gig_id: 149055883
is_pro: true
status: APPROVED
price_i: 500
seller_level: top_rated_seller
seller_rating:
count: 113
score: 4.990741
is_active: true
description: Example seller profile.
hourly_rate:
price_in_cents: 25000
seller_level: LEVEL_TRS
response_time:
in_hours: 3
is_on_vacation: false
one_liner_title: Commercial Product Photography and Video
achievement_level: TOP_RATED_SELLER
approved_gigs_count: 3
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Fiverr
components:
parameters:
fields:
name: fields
in: query
required: false
description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
schema:
type: string
is_async:
name: is_async
in: query
required: false
description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
schema:
type: boolean
default: false
soft_fail:
name: soft_fail
in: query
required: false
description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
schema:
type: boolean
default: false
schemas:
ErrorResponse:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable error message.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Your API key. Include it in the x-api-key header for every request.