Submit Facebook Marketplace Item task
curl --request POST \
--url https://api.socq.ai/v1/facebook-marketplace/item \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"https://www.facebook.com/marketplace/item/1656586118821988/"
]
}
'import requests
url = "https://api.socq.ai/v1/facebook-marketplace/item"
payload = { "urls": ["https://www.facebook.com/marketplace/item/1656586118821988/"] }
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({urls: ['https://www.facebook.com/marketplace/item/1656586118821988/']})
};
fetch('https://api.socq.ai/v1/facebook-marketplace/item', 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.socq.ai/v1/facebook-marketplace/item",
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([
'urls' => [
'https://www.facebook.com/marketplace/item/1656586118821988/'
]
]),
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.socq.ai/v1/facebook-marketplace/item"
payload := strings.NewReader("{\n \"urls\": [\n \"https://www.facebook.com/marketplace/item/1656586118821988/\"\n ]\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.socq.ai/v1/facebook-marketplace/item")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"https://www.facebook.com/marketplace/item/1656586118821988/\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/facebook-marketplace/item")
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 \"urls\": [\n \"https://www.facebook.com/marketplace/item/1656586118821988/\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "A1B2C3D4E5F6G7H8",
"status": "queued",
"created_time": "2026-07-17T10:29:30"
}
}{
"code": 123,
"error": {
"message": "<string>",
"type": "<string>"
}
}{
"code": 123,
"error": {
"message": "<string>",
"type": "<string>"
}
}{
"code": 123,
"error": {
"message": "<string>",
"type": "<string>"
}
}Marketplace Item
Collect public Facebook Marketplace item details by URL.
POST
/
v1
/
facebook-marketplace
/
item
Submit Facebook Marketplace Item task
curl --request POST \
--url https://api.socq.ai/v1/facebook-marketplace/item \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"urls": [
"https://www.facebook.com/marketplace/item/1656586118821988/"
]
}
'import requests
url = "https://api.socq.ai/v1/facebook-marketplace/item"
payload = { "urls": ["https://www.facebook.com/marketplace/item/1656586118821988/"] }
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({urls: ['https://www.facebook.com/marketplace/item/1656586118821988/']})
};
fetch('https://api.socq.ai/v1/facebook-marketplace/item', 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.socq.ai/v1/facebook-marketplace/item",
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([
'urls' => [
'https://www.facebook.com/marketplace/item/1656586118821988/'
]
]),
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.socq.ai/v1/facebook-marketplace/item"
payload := strings.NewReader("{\n \"urls\": [\n \"https://www.facebook.com/marketplace/item/1656586118821988/\"\n ]\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.socq.ai/v1/facebook-marketplace/item")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"urls\": [\n \"https://www.facebook.com/marketplace/item/1656586118821988/\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/facebook-marketplace/item")
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 \"urls\": [\n \"https://www.facebook.com/marketplace/item/1656586118821988/\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "A1B2C3D4E5F6G7H8",
"status": "queued",
"created_time": "2026-07-17T10:29:30"
}
}{
"code": 123,
"error": {
"message": "<string>",
"type": "<string>"
}
}{
"code": 123,
"error": {
"message": "<string>",
"type": "<string>"
}
}{
"code": 123,
"error": {
"message": "<string>",
"type": "<string>"
}
}Marketplace Item
Collect detailed listing information from one or more public Marketplace item URLs. Each URL is processed independently and can produce at most one listing. If an item is unavailable or not found, the remaining URLs continue processing.Request Example
{
"urls": [
"https://www.facebook.com/marketplace/item/1656586118821988/"
]
}
Completed Task Response
{
"code": 200,
"data": {
"task_id": "A1B2C3D4E5F6G7H8",
"status": "succeeded",
"public_id": "facebook-marketplace/item",
"result_count": 1,
"credits_amount": 0.6,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"items": [{
"id": "1656586118821988",
"platform": "facebook-marketplace",
"resource": "item",
"type": "listing",
"url": "https://www.facebook.com/marketplace/item/1656586118821988/",
"name": "Mountain bike",
"text": "Used bike in good condition.",
"author": {"id": null, "username": null, "name": null, "url": null},
"metrics": {},
"media": [{"type": "image", "url": "https://example.com/item.jpg", "width": 960, "height": 720}],
"created_at": "2026-05-15T16:57:39",
"collected_at": "2026-07-18T10:30:00",
"extra": {
"input_url": "https://www.facebook.com/marketplace/item/1656586118821988/",
"price": {"amount": 380, "currency": "USD", "formatted": "$380"},
"location": {"text": "Austin, TX", "latitude": 30.4019, "longitude": -97.7618},
"attributes": [{"attribute_name": "Condition", "value": "used_good", "label": "Used - Good"}],
"is_live": true,
"is_sold": false
}
}]
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
⌘I

