Investigación en redes sociales

curl --request POST \
  --url https://api.glasser.ai/v1/solutions/gtm/social_research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "query": "<string>",
  "handle": "<string>",
  "url": "<string>",
  "task_id": "<string>",
  "metadata": {}
}
'

import requests

url = "https://api.glasser.ai/v1/solutions/gtm/social_research"

payload = {
    "query": "<string>",
    "handle": "<string>",
    "url": "<string>",
    "task_id": "<string>",
    "metadata": {}
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: '<string>',
    handle: '<string>',
    url: '<string>',
    task_id: '<string>',
    metadata: {}
  })
};

fetch('https://api.glasser.ai/v1/solutions/gtm/social_research', 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.glasser.ai/v1/solutions/gtm/social_research",
  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' => '<string>',
    'handle' => '<string>',
    'url' => '<string>',
    'task_id' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "idempotency-key: <idempotency-key>"
  ],
]);

$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.glasser.ai/v1/solutions/gtm/social_research"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"url\": \"<string>\",\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")

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

	req.Header.Add("idempotency-key", "<idempotency-key>")
	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.glasser.ai/v1/solutions/gtm/social_research")
  .header("idempotency-key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"url\": \"<string>\",\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.glasser.ai/v1/solutions/gtm/social_research")

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

request = Net::HTTP::Post.new(url)
request["idempotency-key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"url\": \"<string>\",\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}"

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

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "platform": "<string>",
    "handle": "<string>",
    "name": "<string>",
    "url": "<string>",
    "bio": "<string>",
    "headline": "<string>",
    "website": "<string>",
    "followers": 123,
    "following": 123,
    "posts": 123,
    "verified": true
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "<string>",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "platform": "<string>",
    "handle": "<string>",
    "name": "<string>",
    "url": "<string>",
    "bio": "<string>",
    "headline": "<string>",
    "website": "<string>",
    "followers": 123,
    "following": 123,
    "posts": 123,
    "verified": true
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "<string>",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "unauthorized",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "endpoint_not_permitted",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "rate_limited",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "service_unavailable",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

POST

solutions

gtm

social_research

Investigación en redes sociales

curl --request POST \
  --url https://api.glasser.ai/v1/solutions/gtm/social_research \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: <idempotency-key>' \
  --data '
{
  "query": "<string>",
  "handle": "<string>",
  "url": "<string>",
  "task_id": "<string>",
  "metadata": {}
}
'

import requests

url = "https://api.glasser.ai/v1/solutions/gtm/social_research"

payload = {
    "query": "<string>",
    "handle": "<string>",
    "url": "<string>",
    "task_id": "<string>",
    "metadata": {}
}
headers = {
    "idempotency-key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'idempotency-key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: '<string>',
    handle: '<string>',
    url: '<string>',
    task_id: '<string>',
    metadata: {}
  })
};

fetch('https://api.glasser.ai/v1/solutions/gtm/social_research', 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.glasser.ai/v1/solutions/gtm/social_research",
  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' => '<string>',
    'handle' => '<string>',
    'url' => '<string>',
    'task_id' => '<string>',
    'metadata' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "idempotency-key: <idempotency-key>"
  ],
]);

$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.glasser.ai/v1/solutions/gtm/social_research"

	payload := strings.NewReader("{\n  \"query\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"url\": \"<string>\",\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")

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

	req.Header.Add("idempotency-key", "<idempotency-key>")
	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.glasser.ai/v1/solutions/gtm/social_research")
  .header("idempotency-key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"url\": \"<string>\",\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.glasser.ai/v1/solutions/gtm/social_research")

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

request = Net::HTTP::Post.new(url)
request["idempotency-key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"<string>\",\n  \"handle\": \"<string>\",\n  \"url\": \"<string>\",\n  \"task_id\": \"<string>\",\n  \"metadata\": {}\n}"

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

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "platform": "<string>",
    "handle": "<string>",
    "name": "<string>",
    "url": "<string>",
    "bio": "<string>",
    "headline": "<string>",
    "website": "<string>",
    "followers": 123,
    "following": 123,
    "posts": 123,
    "verified": true
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "<string>",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "id": "<string>",
  "run_url": "<string>",
  "provider": "<string>",
  "endpoint": "<string>",
  "endpoint_version": 123,
  "status": "QUEUED",
  "failure": {
    "kind": "TIMED_OUT",
    "message": "<string>"
  },
  "input": {},
  "output": {
    "platform": "<string>",
    "handle": "<string>",
    "name": "<string>",
    "url": "<string>",
    "bio": "<string>",
    "headline": "<string>",
    "website": "<string>",
    "followers": 123,
    "following": 123,
    "posts": 123,
    "verified": true
  },
  "provider_response": {
    "http_status": 349,
    "error": null
  },
  "charge_usd": "<string>",
  "charge_basis": {
    "clause": "rule",
    "quantity": 1
  },
  "stoppable": true,
  "stop_requested_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "task_id": "<string>",
  "metadata": {},
  "action": "<string>",
  "result_status": "success",
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "runs": [
    {
      "id": "<string>",
      "run_url": "<string>",
      "provider": "<string>",
      "endpoint": "<string>",
      "endpoint_version": 123,
      "status": "QUEUED",
      "failure": {
        "kind": "TIMED_OUT",
        "message": "<string>"
      },
      "input": {
        "omitted": true
      },
      "output": {
        "omitted": true
      },
      "provider_response": {
        "http_status": 349
      },
      "charge_usd": "<string>",
      "charge_basis": {
        "clause": "rule",
        "quantity": 1
      },
      "stoppable": true,
      "stop_requested_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "task_id": "<string>",
      "metadata": {}
    }
  ],
  "result_url": "<string>"
}

{
  "error": {
    "code": "validation_failed",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "unauthorized",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "insufficient_balance",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "endpoint_not_permitted",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "idempotency_conflict",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "rate_limited",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "code": "service_unavailable",
    "message": "<string>",
    "reason": "<string>",
    "control": "<string>",
    "retry_after_ms": 123,
    "details": {}
  },
  "request_id": "<string>"
}

Cada modo devuelve output normalizado, compartido por las seis plataformas. La salida nativa del proveedor no se repite allí; permanece en el Run y se puede leer con Get Run. Un valor que una plataforma o un proveedor no informe es null. Lee result_status por separado de status: success, no_result, error o pending. Una respuesta vacía pero válida es no_result y conserva la estructura del modo: items o profiles es [], o todos los campos son null. charge_usd suma el runs de esta respuesta. Para una ruta de Apify pendiente (HTTP 202), sigue el result_url autenticado. Consulta Selección de Provider y cargos.

Salida por modo

Los campos siguen las convenciones de campos.

`mode`	`output`
`profile`	`platform`, `handle`, `name`, `url`, `bio`, `headline`, `website`, `followers`, `following`, `posts`, `verified`
`search`	`items[]`: `id`, `url`, `title`, `text`, `author`, `author_url`, `published_at`, `likes`, `comments`, `shares`, `views`
`feed`	`items[]`: los mismos campos de publicación
`post`	`id`, `url`, `title`, `text`, `author`, `author_url`, `published_at`, `likes`, `comments`, `shares`, `views`
`find`	`profiles[]`: `platform`, `url`, `handle`, `scrapecreators_confidence`, `followers` (para Reddit: subreddits coincidentes); `pdl_likelihood` de nivel superior

published_at está en UTC según ISO 8601, o null cuando el proveedor no proporciona una hora exacta (resultados de búsqueda de YouTube).
title es el título de Reddit o YouTube. text es únicamente el cuerpo (self-text de Reddit, descripción de YouTube, el tuit, el texto de la leyenda o de la publicación), y es null cuando no existe.
bio es la descripción de texto libre (en LinkedIn: la sección About). headline es la línea del cargo de LinkedIn. website es el sitio propio de la cuenta: el sitio web de la empresa en LinkedIn o el enlace ampliado del perfil de X.
likes es la puntuación neta de Reddit (puede ser negativa), los favoritos de X, los diggs de TikTok, o los «me gusta» y las reacciones en otros sitios. shares son los retuits de X, los envíos mediante la hoja de compartir de TikTok o las republicaciones de LinkedIn. views son las impresiones de X, las reproducciones de TikTok o las visualizaciones de videos de YouTube e Instagram.
En find, platform es el nombre de la red en minúsculas (twitter se convierte en x), y handle se puede usar como el handle de social_research. scrapecreators_confidence es la puntuación de 0 a 1 de ScrapeCreators por perfil. pdl_likelihood es la puntuación de coincidencia de 1 a 10 de People Data Labs para la persona completa, y solo se completa en linkedin.find.
El id de LinkedIn es el id de actividad sin formato, sin el prefijo urn:li:activity:.

{
  "action": "x.feed",
  "provider": "scrapecreators",
  "status": "COMPLETED",
  "result_status": "success",
  "output": {
    "items": [
      { "id": "2110166802315804689", "url": "https://x.com/stripe/status/2110166802315804689", "title": null, "text": "You can now use Underdog…", "author": "stripe", "author_url": "https://x.com/stripe", "published_at": "2026-10-14T00:32:25Z", "likes": 55, "comments": 21, "shares": 6, "views": 8447 }
    ]
  },
  "charge_usd": "0.00188",
  "runs": [{ "provider": "scrapecreators", "status": "COMPLETED", "charge_usd": "0.00188" }],
  "result_url": "/v1/solutions/gtm/social_research/result?token=…"
}

Encabezados

idempotency-key

string

requerido

Genera un valor único para cada ejecución prevista (se recomienda un UUID). Reintenta con la misma clave y los mismos parámetros de ejecución para recuperar el Run original sin un segundo cobro. Cambiar los parámetros de ejecución con la misma clave devuelve 409; cambiar task_id o metadata no actualiza el Run original.

Minimum string length: 1

Cuerpo

application/json

platform

enum<string>

requerido

Opciones disponibles:

reddit,

x,

youtube,

tiktok,

instagram,

linkedin

mode

enum<string> | null

Predeterminado: search. Todas las plataformas admiten cada modo.

search: publicaciones que coinciden con query.
profile: datos de la cuenta a partir del handle (Reddit: subreddit). Para LinkedIn, proporciona una url de persona o empresa.
feed: publicaciones o vídeos recientes de un handle. Para LinkedIn, proporciona una url de empresa.
post: una publicación o vídeo a partir de url.
find: otros perfiles sociales a partir del handle. Para LinkedIn, proporciona la url del perfil de una persona; para Reddit, proporciona query para encontrar subreddits.

Opciones disponibles:

search,

profile,

feed,

post,

find

provider

enum<string> | null

Predeterminado auto: selecciona el primer proveedor de datos elegible según el orden de preferencia de Glasser. Un proveedor de datos especificado debe admitir la solicitud y estar permitido por tu API Key; no se recurre a otro proveedor de datos. Los valores disponibles se indican a continuación.

Opciones disponibles:

auto,

scrapecreators,

apify,

tikhub,

pdl

query

string | null

Required string length: 1 - 500

handle

string | null

Un nombre de usuario sin @ o un nombre de subreddit sin r/.

Required string length: 1 - 100

url

string | null

Required string length: 1 - 2048

task_id

string | null

Agrupa los Runs relacionados, incluido el fallback automático, en un solo Task. Reutiliza una cadena estable y filtra la lista de Runs por task para recuperarlos.

metadata

Campos de seguimiento opcionales, devueltos en el Run y disponibles como filtros. Nunca se envían al proveedor de datos ni afectan al enrutamiento, al Price ni a la idempotencia.

Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra y tener como máximo 40 caracteres.
Valores: cadenas de entre 1 y 500 caracteres.
user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre.

Las entradas no válidas se descartan por completo, sin truncarlas. La solicitud continúa y el Run devuelve los campos que se almacenaron.

Show child attributes

Respuesta

Éxito

string

requerido

run_url

string

requerido

Abre este Run en la consola. Requiere pertenencia al Workspace.

provider

string

requerido

Pattern: ^[a-z0-9][a-z0-9-]*$

endpoint

string

requerido

Pattern: ^\/.+$

endpoint_version

integer

requerido

status

enum<string>

requerido

QUEUED o RUNNING: todavía está en curso. COMPLETED: hay una respuesta del proveedor de datos disponible, incluidas las respuestas no-2xx. FAILED: consulta failure. STOPPED: detenido antes del envío. Consulta charge_usd por separado de status.

Opciones disponibles:

QUEUED,

RUNNING,

COMPLETED,

FAILED,

STOPPED

failure

object | null

requerido

Motivo por el que falló el Run. Solo es distinto de null cuando status es FAILED.

Show child attributes

input

object

requerido

output

object

requerido

Campos normalizados por modo, compartidos por todas las plataformas. El resultado nativo del proveedor de datos no se repite aquí; permanece en el Run (GET /v1/runs/:id). Los valores que la plataforma o el proveedor de datos no informan son null.

profile: platform, handle, name, url, bio, headline, website, followers, following, posts, verified
search: items[]: id, url, title, text, author, author_url, published_at, likes, comments, shares, views
feed: items[]: mismos campos de publicación que search
post: id, url, title, text, author, author_url, published_at, likes, comments, shares, views
find: profiles[]: platform, url, handle, scrapecreators_confidence, followers (Reddit: subreddits coincidentes); pdl_likelihood

Option 1
Option 2
Option 3
Option 4

Show child attributes

provider_response

object | null

requerido

Solo es distinto de null cuando status es COMPLETED.

En las respuestas 2xx, output contiene JSON nativo del proveedor de datos (de cualquier estructura) o null si el cuerpo está vacío.
En las respuestas no-2xx, error contiene el cuerpo del error del proveedor de datos y output es null.

Los campos sensibles se eliminan de ambos cuerpos.

Show child attributes

charge_usd

string | null

requerido

Cargo total de los Runs en esta respuesta de Solution. Es null hasta que todos los Runs indicados se liquiden. Cada Run conserva su propio cargo; los fallos también pueden generar cargos.

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$

charge_basis

object | null

requerido

Base del cargo de un único Run o null para un total de varios Runs. Consulta runs[].charge_basis para cada cargo.

Show child attributes

stoppable

boolean

requerido

Indica si actualmente se puede aceptar una solicitud de detención. Esto no garantiza que el Run pueda detenerse antes del envío.

stop_requested_at

string<date-time> | null

requerido

Momento en que se solicitó la detención. El Run puede continuar si el envío ya había comenzado.

created_at

string<date-time>

requerido

Marca de tiempo UTC ISO-8601

started_at

string<date-time> | null

requerido

Marca de tiempo UTC ISO-8601

completed_at

string<date-time> | null

requerido

Marca de tiempo UTC ISO-8601

task_id

string | null

requerido

metadata

object

requerido

Tus campos de seguimiento almacenados. Úsalos para filtrar Runs. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia.

Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra; como máximo 40 caracteres.
Valores: cadenas de 1–500 caracteres.
user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre.

Show child attributes

action

string

requerido

<platform>.<mode>; una página de empresa de LinkedIn en modo de perfil es linkedin.company.

Pattern: ^[a-z]+\.[a-z]+$

result_status

enum<string>

requerido

Estado de entrega empresarial, independiente del ciclo de vida final del Run en status. no_result es una respuesta vacía pero válida; error significa que no se pudo entregar la salida del proveedor de datos.

Opciones disponibles:

success,

no_result,

error,

pending

error

object | null

requerido

Show child attributes

runs

object[]

requerido

Show child attributes

result_url

string

requerido

Ruta de URL autenticada y de solo lectura para consultar este resultado normalizado y el cargo total. Úsala con el origen de la API. No crea Runs ni reanuda el fallback. GET /v1/runs/:id sigue devolviendo el Run nativo e individual.

Primeros pasos

Endpoints

Run

Saldo

Fuentes de datos

Solutions

Investigación en redes sociales

Salida por modo

Encabezados

Cuerpo

Respuesta

​Salida por modo

Encabezados

Cuerpo

Respuesta

Salida por modo