Firecrawl Search

Run a web search and return ranked results.

curl --request POST \
  --url https://api.aisa.one/apis/v1/firecrawl/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "firecrawl web scraping api",
  "limit": 10
}
'

import requests

url = "https://api.aisa.one/apis/v1/firecrawl/search"

payload = {
    "query": "firecrawl web scraping api",
    "limit": 10
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'firecrawl web scraping api', limit: 10})
};

fetch('https://api.aisa.one/apis/v1/firecrawl/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/firecrawl/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'firecrawl web scraping api',
    'limit' => 10
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/firecrawl/search"

	payload := strings.NewReader("{\n  \"query\": \"firecrawl web scraping api\",\n  \"limit\": 10\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/firecrawl/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"firecrawl web scraping api\",\n  \"limit\": 10\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/firecrawl/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"firecrawl web scraping api\",\n  \"limit\": 10\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "web": [
      {
        "title": "<string>",
        "url": "<string>",
        "description": "<string>"
      }
    ]
  },
  "creditsUsed": 123
}

POST

https://api.aisa.one/apis/v1

firecrawl

Run a web search and return ranked results.

curl --request POST \
  --url https://api.aisa.one/apis/v1/firecrawl/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "firecrawl web scraping api",
  "limit": 10
}
'

import requests

url = "https://api.aisa.one/apis/v1/firecrawl/search"

payload = {
    "query": "firecrawl web scraping api",
    "limit": 10
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({query: 'firecrawl web scraping api', limit: 10})
};

fetch('https://api.aisa.one/apis/v1/firecrawl/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/firecrawl/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'firecrawl web scraping api',
    'limit' => 10
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/firecrawl/search"

	payload := strings.NewReader("{\n  \"query\": \"firecrawl web scraping api\",\n  \"limit\": 10\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/firecrawl/search")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"firecrawl web scraping api\",\n  \"limit\": 10\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/firecrawl/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"firecrawl web scraping api\",\n  \"limit\": 10\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "web": [
      {
        "title": "<string>",
        "url": "<string>",
        "description": "<string>"
      }
    ]
  },
  "creditsUsed": 123
}

Search the web and get back ranked results. Provide a non-empty query (up to 500 characters) and an optional limit (default 10, max 100). On the AIsa metered profile only the web source is supported — scrapeOptions, enterprise mode, and non-web sources are rejected. Billing is metered per Firecrawl credit and scales with how many results you request: roughly 2 credits per 10 results (credits = ceil(limit / 10) * 2). When you already know the exact pages, post_firecrawl-scrape is cheaper and more precise than searching for them.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query

string

required

The search query. Must be non-empty and at most 500 characters.

Maximum string length: 500

Example:

"firecrawl web scraping api"

limit

integer

default:10

Maximum number of results to return.

Required range: 1 <= x <= 100

Response

200 - application/json

Search completed successfully.

success

boolean

True when the search succeeded.

data

object

Show child attributes

creditsUsed

integer

Firecrawl credits consumed (about 2 per 10 results).

Overview

Chat API

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Essentials

Firecrawl Search

Authorizations

Body

Response