Scrappa's GET /api/fiverr/search returns public gigs from Fiverr's search page.
Input
query, category, seller_level and page are sent to Fiverr's public search. price (maximum USD) and delivery (maximum days) filter the returned page locally; they do not change the upstream window. seller_level accepts level_1, level_2 and top_rated, and matches live Level One, Level Two and Top Rated sellers. Every listed filter is applied before a row is returned. Page N never carries page 1 data. When a local filter is active, pagination.total is null and has_more still describes the unfiltered upstream window, so a narrow filter can keep only one row while more result pages exist. Prices are quoted in USD. Fiverr publishes a canonical USD amount in the search island. That amount stays the same when the page shows another display currency, so the returned price is the canonical USD value and the display currency is ignored.
What you get
data.gigs[] has id, title, url, seller (name, level, country), price (amount, currency), rating, reviews, delivery_days and a full-size image URL. data.pagination has page, total and has_more, and data.currency names the currency. Prices, ratings and review counts are numbers. Fields Fiverr does not publish stay null.
Credits
A successful request costs 1 credit. Errors and blocks cost nothing. The response shows the charge in meta.credits_charged.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
6 optional filters available.
string
Optional
Keywords for the gig search.
logo design
string
Optional
Fiverr category slug.
example
number
Optional
Maximum price in USD.
10
integer
Optional
Maximum delivery time in days.
10
string
Optional
level_1, level_2 or top_rated.
example
integer
Optional
Page number, starting at 1.
1
Request Examples
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrappa.co/api/fiverr/search?query=logo+design&page=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: YOUR_API_KEY_HERE"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
<?php
use Illuminate\Support\Facades\Http;
$response = Http::timeout(30)
->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
->get('https://scrappa.co/api/fiverr/search?query=logo+design&page=1');
if ($response->successful()) {
echo $response->body();
} else {
echo "Error: " . $response->status();
}
const options = {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
};
fetch('https://scrappa.co/api/fiverr/search?query=logo+design&page=1', options)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.text();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://scrappa.co/api/fiverr/search?query=logo+design&page=1',
headers: {
x-api-key: 'YOUR_API_KEY_HERE',
}
};
try {
const response = await axios(options);
console.log(response.data);
} catch (error) {
console.error('Error:', error.message);
}
require 'net/http'
require 'uri'
uri = URI.parse("https://scrappa.co/api/fiverr/search?query=logo+design&page=1")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'
begin
response = http.request(request)
puts response.body
rescue => e
puts "Error: #{e.message}"
end
import http.client
import json
conn = http.client.HTTPSConnection("scrappa.co")
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
conn.request("GET", "/api/fiverr/search?query=logo+design&page=1", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
except Exception as e:
print(f"Error: {e}")
finally:
conn.close()
import requests
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
response = requests.get('https://scrappa.co/api/fiverr/search?query=logo+design&page=1', headers=headers)
response.raise_for_status()
print(response.text)
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class ApiExample {
public static void main(String[] args) {
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://scrappa.co/api/fiverr/search?query=logo+design&page=1")
.addHeader("x-api-key", "YOUR_API_KEY_HERE")
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
System.out.println(response.body().string());
} else {
System.out.println("Error: " + response.code());
}
} catch (IOException e) {
System.out.println("Error: " + e.getMessage());
}
}
}
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
client := &http.Client{}
req, err := http.NewRequest("GET", "https://scrappa.co/api/fiverr/search?query=logo+design&page=1", nil)
if err != nil {
fmt.Println("Error creating request:", err)
return
}
req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error making request:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
fmt.Println(string(body))
}
#!/bin/bash
curl -X GET \
-H "x-api-key: YOUR_API_KEY_HERE" \
"https://scrappa.co/api/fiverr/search?query=logo+design&page=1"
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");
try
{
var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/fiverr/search?query=logo+design&page=1"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
import axios from 'axios';
async function run(): Promise<void> {
try {
const response = await axios({
method: 'GET',
url: 'https://scrappa.co/api/fiverr/search?query=logo+design&page=1',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE',
},
});
console.log(response.data);
} catch (error) {
console.error('Error:', error);
}
}
void run();
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://scrappa.co/api/fiverr/search?query=logo+design&page=1")
.header("x-api-key", "YOUR_API_KEY_HERE")
.send()
.await?;
println!("{}", response.text().await?);
Ok(())
}
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
success
data
meta
{
"success": true,
"data": {
"gigs": [
{
"id": "seller_user/modern-logo-design",
"title": "I will design a modern logo",
"url": "https://www.fiverr.com/seller_user/modern-logo-design",
"seller": {
"name": "seller_user",
"level": "Level 2",
"country": "US"
},
"price": {
"amount": 45,
"currency": "USD"
},
"rating": 4.9,
"reviews": 320,
"delivery_days": 3,
"image": "https://fiverr-res.cloudinary.com/images/t_main1/q_auto/f_auto/v1/-modern-logo.png"
}
],
"pagination": {
"page": 1,
"total": 12000,
"has_more": true
},
"currency": "USD"
},
"meta": {
"endpoint_family": "fiverr.search",
"billable": true,
"credits_charged": 1
}
}
Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing, unknown or unusable. Only page 1 of reviews is public. Non-billable.
{
"message": "Only the first page of Fiverr reviews is public."
}Upstream Unavailable
Fiverr blocked the request or could not be reached. Non-billable. Clients are never rate limited.
{
"error": {
"code": "upstream_blocked",
"message": "Fiverr blocked this request. Please retry later."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.