Amazon Syphoon API Documentation

Overview

The Amazon Syphoon API enables developers to access Amazon webpages.

This documentation covers endpoints, authentication, rate limits, error handling, and best practices, with general structures and detailed examples for API responses.

Endpoint

URL: https://api.syphoon.com
Method: POST

Sample POST Body for API URL:

{
  "url": "https://www.amazon.com/dp/B07X41PWTY",
  "key": "SYPHOON_KEY",
  "method": "GET"
}

Sample cURL

 curl --location 'https://api.syphoon.com/' --header 'Content-Type: application/json' --data '{
 "url": "https://www.amazon.com/dp/B07X41PWTY",
 "key": "SYPHOON_KEY",
 "method": "GET"
}

import requests
 
json_data = {
'key': 'YOUR_API_KEY',
'url': 'https://www.amazon.com/dp/B07X41PWTY',
'method': 'GET',
}
 
response = requests.post('https://api.syphoon.com', json=json_data)
 
print(response.json())

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
 
class Program
{
static async Task Main()
{
    using HttpClient client = new HttpClient();
    string url = "https://api.syphoon.com/";
 
    var requestData = new
    {
        url = "https://www.amazon.com/dp/B07X41PWTY",
        key = "SYPHOON_KEY",
        method = "GET"
    };
 
    var json = System.Text.Json.JsonSerializer.Serialize(requestData);
    var content = new StringContent(json, Encoding.UTF8, "application/json");
 
    HttpResponseMessage response = await client.PostAsync(url, content);
    string responseBody = await response.Content.ReadAsStringAsync();
 
    Console.WriteLine(responseBody);
}
}

package main
 
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
 
func main() {
url := "https://api.syphoon.com/"
requestBody, _ := json.Marshal(map[string]string{
	"url":    "https://www.amazon.com/dp/B07X41PWTY",
	"key":    "SYPHOON_KEY",
	"method": "GET",
})
 
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(requestBody))
req.Header.Set("Content-Type", "application/json")
 
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
	fmt.Println("Error:", err)
	return
}
defer resp.Body.Close()
 
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
 
responseJSON, _ := json.MarshalIndent(result, "", "    ")
fmt.Println(string(responseJSON))
}

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;
import org.json.JSONObject;
 
public class SyphoonAPI {
public static void main(String[] args) {
    try {
        URL url = new URL("https://api.syphoon.com/");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/json");
        conn.setDoOutput(true);
 
        JSONObject jsonRequest = new JSONObject();
        jsonRequest.put("url", "https://www.amazon.com/dp/B07X41PWTY");
        jsonRequest.put("key", "SYPHOON_KEY");
        jsonRequest.put("method", "GET");
 
        OutputStream os = conn.getOutputStream();
        os.write(jsonRequest.toString().getBytes());
        os.flush();
 
        Scanner scanner = new Scanner(conn.getInputStream());
        String response = scanner.useDelimiter("\\A").next();
        scanner.close();
 
        System.out.println(new JSONObject(response).toString(4));
 
    } catch (Exception e) {
        e.printStackTrace();
    }
}
}

const axios = require("axios");
 
const url = "https://api.syphoon.com/";
const data = {
url: "https://www.amazon.com/dp/B07X41PWTY",
key: "SYPHOON_KEY",
method: "GET"
};
 
axios.post(url, data, { headers: { "Content-Type": "application/json" } })
.then(response => console.log(JSON.stringify(response.data, null, 4)))
.catch(error => console.error("Error:", error.response?.data || error.message));

<?php
$url = "https://api.syphoon.com/";
 
$data = json_encode([
"url" => "https://www.amazon.com/dp/B07X41PWTY",
"key" => "SYPHOON_KEY",
"method" => "GET"
]);
 
$options = [
"http" => [
    "header" => "Content-Type: application/json",
    "method" => "POST",
    "content" => $data
]
];
 
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
 
echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
?>

For search URL

{
"url": "https://www.amazon.com/s?k=T+Shirt",
"key": "SYPHOON_KEY",
"method": "GET"
}

Sample Code

curl --location 'https://api.syphoon.com/' --header 'Content-Type: application/json' --data '{
"url": "https://www.amazon.com/s?k=T+Shirt",
"key": "SYPHOON_KEY",
"method": "GET"
}'

import requests
import json
 
url = "https://api.syphoon.com/"
headers = {"Content-Type": "application/json"}
data = {
"url": "https://www.amazon.com/s?k=T+Shirt",
"key": "SYPHOON_KEY",
"method": "GET"
}
 
response = requests.post(url, json=data, headers=headers)
print(json.dumps(response.json(), indent=4))

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
 
class Program
{
static async Task Main()
{
    using HttpClient client = new HttpClient();
    string url = "https://api.syphoon.com/";
 
    var requestData = new
    {
        url = "https://www.amazon.com/s?k=T+Shirt",
        key = "SYPHOON_KEY",
        method = "GET"
    };
 
    var json = System.Text.Json.JsonSerializer.Serialize(requestData);
    var content = new StringContent(json, Encoding.UTF8, "application/json");
 
    HttpResponseMessage response = await client.PostAsync(url, content);
    string responseBody = await response.Content.ReadAsStringAsync();
 
    Console.WriteLine(responseBody);
}
}

package main
 
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
 
func main() {
url := "https://api.syphoon.com/"
requestBody, _ := json.Marshal(map[string]string{
	"url":    "https://www.amazon.com/s?k=T+Shirt",
	"key":    "SYPHOON_KEY",
	"method": "GET",
})
 
req, _ := http.NewRequest("POST", url, bytes.NewBuffer(requestBody))
req.Header.Set("Content-Type", "application/json")
 
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
	fmt.Println("Error:", err)
	return
}
defer resp.Body.Close()
 
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
 
responseJSON, _ := json.MarshalIndent(result, "", "    ")
fmt.Println(string(responseJSON))
}

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;
import org.json.JSONObject;
 
public class SyphoonAPI {
public static void main(String[] args) {
    try {
        URL url = new URL("https://api.syphoon.com/");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Content-Type", "application/json");
        conn.setDoOutput(true);
 
        JSONObject jsonRequest = new JSONObject();
        jsonRequest.put("url", "https://www.amazon.com/s?k=T+Shirt");
        jsonRequest.put("key", "SYPHOON_KEY");
        jsonRequest.put("method", "GET");
 
        OutputStream os = conn.getOutputStream();
        os.write(jsonRequest.toString().getBytes());
        os.flush();
 
        Scanner scanner = new Scanner(conn.getInputStream());
        String response = scanner.useDelimiter("\\A").next();
        scanner.close();
 
        System.out.println(new JSONObject(response).toString(4));
 
    } catch (Exception e) {
        e.printStackTrace();
    }
}
}

const axios = require("axios");
 
const url = "https://api.syphoon.com/";
const data = {
url: "https://www.amazon.com/s?k=T+Shirt",
key: "SYPHOON_KEY",
method: "GET"
};
 
axios.post(url, data, { headers: { "Content-Type": "application/json" } })
.then(response => console.log(JSON.stringify(response.data, null, 4)))
.catch(error => console.error("Error:", error.response?.data || error.message));

<?php
$url = "https://api.syphoon.com/";
 
$data = json_encode([
"url" => "https://www.amazon.com/s?k=T+Shirt",
"key" => "SYPHOON_KEY",
"method" => "GET"
]);
 
$options = [
"http" => [
    "header" => "Content-Type: application/json",
    "method" => "POST",
    "content" => $data
]
];
 
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
 
echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
?>

Custom Headers and Cookies

By default, we do not allow sending custom headers for Amazon. If you need support for custom headers or cookies, please reach out to support, and we will enable it for you.

Authentication

Each request requires an API key in the POST data, provided upon subscription to the Syphoon service. The API key must be included in every request to authenticate the user.

Rate Limits

The rate limits applied to each user are custom and based on the subscription plan chosen. You should not cross the concurrency you have been assigned because you will get a “Too many requests” error.

Response Structure & Status Codes

For successful responses, you will get the HTML as returned by the Amazon website. The Status Code will be 200 for these responses.

For failed responses, the Status Code can be 4xx or 5xx

Status Code 404 will be returned when the provided Amazon URL is incorrect (404 requests will be charged, so make sure of the URLs)
Status Code 429 will be returned when concurrency limits are breached
Status Code 400 will be returned if Amazon does not send a valid response (these will be charged)
Status Code 5xx will be sent for server errors

We request you to check the Status Code before trying to parse the response. You will only be charged for responses with Status Codes 200, 400 and 404.

For any help or assistance, please don’t hesitate to reach out to support@syphoon.com and we will be glad to help you.

Headless Browser Shopee