NAV Navigering
cURL Python JavaScript

NinjaPear Översikt

NinjaPear är en B2B-plattform för företagsintelligens med fokus på dataägarskap och etisk datainsamling. Som förstapartsleverantör upprätthåller vi ett hållbart ekosystem av proprietär och juridiskt granskad data. Vår mission är att tillhandahålla en tillförlitlig datainfrastruktur som gör det möjligt för företag att med självförtroende utveckla och skala värdeskapande applikationer och arbetsflöden.

För AI-agenter

Bygger du med en AI-kodningsagent? Använd den enkla Markdown-versionen av dessa dokument — optimerad för LLM:er och AI-verktyg som Claude, Cursor och ChatGPT:

AI Skill

NinjaPear AI Skill ger kodningsagenter den procedurmässiga kunskapen att skriva korrekt NinjaPear-integrationskod i dina applikationer. Installera det med ett enda kommando så vet din agent hur man autentiserar, väljer rätt slutpunkt, genererar SDK-kod och hanterar edge cases – allt med inbyggd kostnadsmedvetenhet.

Förutsättningar — En NinjaPear API-nyckel från nubela.co/dashboard och Node.js 18+.

Installera färdigheten med hjälp av npx skills CLI. Välj kommandot för din agent:

Claude Code

npx skills add NinjaPear/ninjapear-skill -a claude-code

Codex

npx skills add NinjaPear/ninjapear-skill -a codex

Opencode

npx skills add NinjaPear/ninjapear-skill -a opencode

Vad kompetensen tillhandahåller

När det är installerat ger skickligheten din kodningsagent procedurell kunskap för att arbeta korrekt med NinjaPear:

Möjlighet Beskrivning
Autentiseringsinställning Konfigurera API-nycklar via miljövariabler och SDK-initiering
Val av slutpunkt Välj rätt NinjaPear API-slutpunkt med kostnadsmedvetenhet
Python SDK-integration Generera korrekt kod med hjälp av ninjapear Python-paket
JavaScript SDK-integration Generera korrekt kod med hjälp av ninjapear npm-paket
Pagineringshantering Implementera markörbaserad paginering för listslutpunkter
Hantering av taxeringsgränser Respektera hastighetsgränser med korrekt försök igen och backoff-logik
Felhantering Hantera alla NinjaPear-felkoder (401, 403, 404, 429, 500, 503)
Timeout-konfiguration Ställ in lämpliga timeouts för långvariga slutpunkter

Förklara det för mig som om jag vore 5 år

Autentisering

curl "https://nubela.co/api/v1/customer/listing" \
  -H "Authorization: Bearer YOUR_API_KEY"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CustomerAPIApi(api_client)
    response = api.get_customer_listing(website="https://example.com")

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
var bearerAuth = defaultClient.authentications["bearerAuth"];
bearerAuth.accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CustomerAPIApi();
api.getCustomerListing("https://example.com").then(function (data) {
  console.log(data);
});

NinjaPear:s API använder bearer-tokens för att autentisera användare. Varje användare tilldelas en slumpmässigt genererad hemlig nyckel under API-avsnittet i Instrumentpanelen.

Bearer-token injiceras i Authorization header.

Klientbibliotek

Vi tillhandahåller officiella klientbibliotek för JavaScript och Python för att göra det enklare att integrera med NinjaPear API.

JavaScript (Node.js)

npm install ninjapear

# JavaScript library - see JavaScript tab

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
var bearerAuth = defaultClient.authentications["bearerAuth"];
bearerAuth.accessToken = "YOUR_API_KEY";

// Now you can use any API class
var companyApi = new NinjaPear.CompanyAPIApi();
var customerApi = new NinjaPear.CustomerAPIApi();
var productApi = new NinjaPear.ProductAPIApi();
var contactApi = new NinjaPear.ContactAPIApi();
var metaApi = new NinjaPear.MetaAPIApi();

Python

uv add ninjapear
# or: pip install ninjapear

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

# Use the client with a context manager
with ninjapear.ApiClient(configuration) as api_client:
    company_api = ninjapear.CompanyAPIApi(api_client)
    customer_api = ninjapear.CustomerAPIApi(api_client)
    product_api = ninjapear.ProductAPIApi(api_client)
    contact_api = ninjapear.ContactAPIApi(api_client)
    meta_api = ninjapear.MetaAPIApi(api_client)

// Python library - see Python tab

Hastighetsgräns

Hastighetsgränser tillämpas per produktkonto och delas av alla API-nycklar under den produkten.

Betalda API-slutpunkter är begränsade till 50 förfrågningar per minut.

För hastighetsbegränsning räknas Monitor-flödes- och målhanteringens slutpunkter som betald API-trafik även när slutpunktens kreditkostnad är 0.

Vid hög belastning kan vårt system skärpa hastighetsgränserna för alla konton för att säkerställa att våra tjänster förblir tillgängliga för alla användare.

Vi returnerar HTTP 429 när du är hastighetsbegränsad. Du kan också ta emot HTTP 429 om kapaciteten på vår sida begränsar oss.

Du bör hantera 429-fel och tillämpa exponentiell backoff.

Hastighetsbegränsade svar inkluderar:

Header Beskrivning
Retry-After Sekunder att vänta innan nytt försök
X-RateLimit-Limit Maximalt antal tillåtna anrop under den aktuella minuten
X-RateLimit-Remaining Återstående förfrågningar under nuvarande minut
X-RateLimit-Reset Unix-tidsstämpel för när den aktuella minuten återställs

Hastighetsgräns för gratis-API:er

För att hållbart tillhandahålla gratis API:er beror hastighetsgränsen för gratis API:er på din prenumerationsplan:

Den kostnadsfria API-hastighetsgränsen gäller för Company Logo, Disposable Email Checker, View Credit Balance och RSS-flödeskonsumtion.

Krediter

Varje giltig förfrågan kräver minst 0.1 kredit för att behandlas, om det inte är en gratis API-slutpunkt.

En kredit förbrukas om och endast om förfrågan tolkas framgångsrikt.

En lyckad förfrågan är en förfrågan som returnerar med ett 200 HTTP-statuskod.

Fakturering av cache

För slutpunkter med ett use_cache med parametern debiteras en produkt inte igen när samma normaliserade förfrågan betjänas från samma cachade postversion som produkten tidigare betalat för. Svaret inkluderar X-NinjaPear-Credit-Cost: 0 för dessa upprepade cacheträffar.

use_cache=never utför alltid en ny hämtning och debiterar normalt. use_cache=if-recent kvalificerar endast för en gratis upprepning så länge den cachade posten befinner sig inom slutpunktens aktualitetsfönster.

För paginerade slutpunkter är gratis upprepad åtkomst begränsad till sidor som redan betalats för med samma fråga, filter, markörkedja och page_size. Betalda paginerade sidor spelas upp exakt vid upprepade cache-träffar, inklusive next_page värde. Senare sidor som ännu inte betalats debiteras normalt.

Timeout och API-svarstid

NinjaPear API-slutpunkter tar emot 30-60 sekunder att slutföra.

Du uppmanas att göra parallella anrop till vår API-tjänst för att maximera genomströmningen. Se detta inlägg om hur du kan maximera genomströmningen.

Vi rekommenderar en timeout på 100 sekunder.

Fel

Dessa är de vanliga felen som kan returneras av vårt API:

HTTP-kod Debitering? Beskrivning
400 Nej Ogiltiga parametrar angivna. Se dokumentationen och meddelandetexten för mer information
401 Nej Ogiltig API-nyckel
403 Nej Du har slut på krediter
404 Ja Den begärda resursen (t.ex. användarprofil, företag) kunde inte hittas
410 Nej Detta API är föråldrat
429 Nej Hastighetsbegränsad. Försök igen
500 Nej Det finns ett fel med vårt API. Vänligen Kontakta oss för hjälp
503 Nej Berikning misslyckades, försök igen.

Du debiteras aldrig för misslyckade förfrågningar.

Garanti för bakåtkompatibilitet

Vi är engagerade i att säkerställa att vårt API förblir bakåtkompatibelt, så att du kan integrera med förtroende. Vår garanti för bakåtkompatibilitet innebär att vi inte kommer att införa ändringar som bryter befintlig funktionalitet eller ta bort slutpunkter utan en avvecklingsperiod.

Mer specifikt kommer vi inte att introducera brytande förändringar på följande sätt:

  1. Vi kommer inte att ta bort dokumenterade parametrar och svarsattribut.
  2. Vi kommer inte att ändra datatypen som dokumenterats i våra API-svar.

Följande betraktas dock inte som inkompatibla ändringar:

Vi rekommenderar starkt att integrera vårt API på ett sätt som inte bryts om nya svarsattribut eller headers introduceras.

Om vi gör ändringar i vårt API tillhandahåller vi tydlig dokumentation och tillräcklig varsel (30 dagar) för att säkerställa en smidig övergång. Meddelanden delas via nyhetsbrev, Twitter/X-inlägg och uppdateringar på vår blogg.

Customer API

Slutpunkt för kundlista

GET /api/v1/customer/listing

Kostnad: 1 kredit / begäran + 2 kredit / företag returnerat. Krediter debiteras även när begäran returnerar ett tomt resultat.

Hämta en lista över högst troliga kunder, investerare och partners/plattformar för ett målföretag, kategoriserade efter relationstyp.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/customer/listing"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CustomerAPIApi(api_client)
    response = api.get_customer_listing(website="https://www.stripe.com")
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CustomerAPIApi();
api.getCustomerListing("https://www.stripe.com").then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "customers": [
    {
      "name": "Apple",
      "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.",
      "tagline": "Think different.",
      "website": "https://www.apple.com",
      "company_logo_url": "https://nubela.co/api/v1/company/logo?website=https%3A%2F%2Fwww.apple.com",
      "id": "abc123",
      "industry": 45202030,
      "specialties": ["Technology", "Consumer Electronics"],
      "x_profile": "https://x.com/Apple"
    }
  ],
  "investors": [
    {
      "name": "Sequoia Capital",
      "description": "Sequoia Capital is a venture capital firm focused on technology companies.",
      "tagline": null,
      "website": "https://www.sequoiacap.com",
      "company_logo_url": "https://nubela.co/api/v1/company/logo?website=https%3A%2F%2Fwww.sequoiacap.com",
      "id": "def456",
      "industry": 40203010,
      "specialties": ["Venture Capital", "Growth Equity"],
      "x_profile": "https://x.com/sequoia"
    }
  ],
  "partner_platforms": [
    {
      "name": "Amazon Web Services",
      "description": "Amazon Web Services provides cloud computing platforms and APIs.",
      "tagline": null,
      "website": "https://aws.amazon.com",
      "company_logo_url": "https://nubela.co/api/v1/company/logo?website=https%3A%2F%2Faws.amazon.com",
      "id": "ghi789",
      "industry": 45101010,
      "specialties": ["Cloud Computing", "Infrastructure"],
      "x_profile": "https://x.com/awscloud"
    }
  ],
  "next_page": "https://nubela.co/api/v1/customer/listing?website=https://www.stripe.com&cursor=abc123"
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://www.stripe.com) rekommenderas starkt för precision. https://www.stripe.com
cursor Nej Pagineringspekare från next_page i ett tidigare svar abc123
page_size Nej Antal resultat per sida (1–200, standard 200) 50
quality_filter Nej Filtrera bort lågkvalitetsresultat (skräp-TLD:er som .top, .xyz och otillgängliga webbplatser). Ange till false för att inkludera alla resultat. (standard: true) false
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (standard; returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-present

Svar

Nyckel Beskrivning Exempel
customers En lista över företag som troligen är kunder till målföretaget. Enheter som betalar för målföretagets produkt/tjänst. Lista över CustomerCompany-objekt
investors En lista över företag som är investerare (riskkapitalbolag, PE-fonder, affärsängelnätverk) i målföretaget. Lista över CustomerCompany-objekt
partner_platforms En lista över företag som är samarbetspartners, plattformar eller tjänsteleverantörer som målföretaget använder eller integrerar med (teknikstack, medier, byråer). Lista över CustomerCompany-objekt
next_page Den API URI som fungerar som markör för paginering. Att följa denna URL med din API-nyckel leder till nästa resultatsida. Detta är null för den sista sidan. https://nubela.co/api/v1/customer/list?...

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Det gick inte att extrahera tillräcklig information om målföretaget
404 Nej Ingen cachad data hittades när use_cache=if-present-only

Kundföretag

Nyckel Beskrivning Exempel
name Företagsnamn "Apple"
description En kort beskrivning av företaget "Apple Inc. designs, manufactures, and markets smartphones..."
tagline Företagets tagline eller slogan "Think different."
webbplats URL till företagets webbplats "https://www.apple.com"
company_logo_url URL till Company Logo API för detta företag. Drivs av Slutpunkt för företagslogotyp. Autentisera med din bearer token. null om ingen webbplats. "https://nubela.co/api/v1/company/logo?website=https%3A%2F%2Fwww.apple.com"
id Unik identifierare "abc123"
industry GICS 8-siffrig branschkod 45202030
specialties Lista över företagets specialområden ["Technology"]
x_profile X (Twitter) profil-URL "https://x.com/Apple"

Notering om company_logo_url: Denna URL drivs av Slutpunkt för företagslogotyp. Autentisera med din Bearer token (samma som huvud-API). Dessa är temporära länkar — det rekommenderade tillvägagångssättet är att ladda ner bilden via URL så snart svaret returneras och lagra bilden på din sida.

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 10
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Competitor API

Konkurrentlistans slutpunkt

GET /api/v1/competitor/listing

Kostnad: 2 krediter / konkurrent returnerad. Minst 5 krediter per förfrågan, debiteras även när inga resultat hittas.

Hämta en lista över konkurrentföretag för ett målföretag, med anledningen till konkurrensen.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/competitor/listing"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompetitorAPIApi(api_client)
    response = api.get_competitor_listing(website="https://www.stripe.com")
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CompetitorAPIApi();
api.getCompetitorListing("https://www.stripe.com").then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "competitors": [
    {
      "company_details_url": "https://nubela.co/api/v1/company/details?website=https://www.adyen.com",
      "website": "https://www.adyen.com",
      "competition_reason": "product_overlap"
    },
    {
      "company_details_url": "https://nubela.co/api/v1/company/details?website=https://squareup.com",
      "website": "https://squareup.com",
      "competition_reason": "product_overlap"
    },
    {
      "company_details_url": "https://nubela.co/api/v1/company/details?website=https://www.checkout.com",
      "website": "https://www.checkout.com",
      "competition_reason": "organic_keyword_overlap"
    }
  ]
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://www.stripe.com) rekommenderas starkt för precision. https://www.stripe.com
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (standard; returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-present

Svar

Nyckel Beskrivning Exempel
competitors En lista över konkurrenter till målföretaget. Lista över Konkurrentföretag objekt

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Det gick inte att extrahera tillräcklig information om målföretaget
404 Nej Ingen cachad data hittades när use_cache=if-present-only

Konkurrentföretag

Nyckel Beskrivning Exempel
company_details_url URL till slutpunkten för företagsdetaljer för denna konkurrent. Autentisera med din bearer-token för att hämta fullständiga företagsdetaljer. "https://nubela.co/api/v1/company/details?website=https://www.adyen.com"
webbplats URL till företagets webbplats "https://www.adyen.com"
competition_reason Varför detta företag anses vara en konkurrent. Ett av värdena från Konkurrensorsak enum. "product_overlap"

Enum för konkurrensorsak

Värde Beskrivning
organic_keyword_overlap Båda företagen rankar för liknande organiska sökord
product_overlap Båda företagen erbjuder liknande produkter eller tjänster

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 4
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Product API

Slutpunkt för produktlistning

GET /api/v1/product/listing

Kostnad: 3 krediter / förfrågan. Krediter debiteras även om inga produkter hittas för ett giltigt företag.

Hämta en lista över produkter och tjänster som erbjuds av ett målföretag.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://matterport.com" \
  "https://nubela.co/api/v1/product/listing"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.ProductAPIApi(api_client)
    response = api.get_product_listing(website="https://matterport.com")
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.ProductAPIApi();
api.getProductListing("https://matterport.com").then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "products": [
    {
      "name": "Matterport Digital Twin Platform",
      "tagline": "Capture, share, and collaborate in immersive 3D.",
      "description": "Matterport's 3D digital twin platform allows users to create immersive 3D models of physical spaces, enabling virtual tours, detailed measurements, and remote collaboration. It helps optimize space planning, manage costs, and streamline project management across various industries.",
      "categories": [
        "3D Modeling",
        "Digital Twins",
        "Virtual Tours",
        "Real Estate",
        "Construction",
        "Facilities Management"
      ],
      "tags": [],
      "structured_features": {
        "3d_insights": true,
        "centralized_management": true,
        "workplace_planning": true,
        "risk_mitigation": true,
        "bim_cad_generation": true,
        "qa_qc_monitoring": true,
        "asset_documentation": true,
        "space_planning": true,
        "capital_project_execution": true,
        "remote_oversight": true,
        "dimensionally_accurate_data": true,
        "secure_cloud_hosting": true
      },
      "freeform_features": [
        "immersive exploration from the palm of your hand",
        "cut the time and cost of workplace planning",
        "accelerating your ability to execute",
        "unmatched 3D visual clarity"
      ],
      "pricing": {
        "model": "unknown",
        "starts_at_monthly_usd": null,
        "tiers": []
      },
      "integrations": [
        "Procore",
        "Autodesk",
        "AWS"
      ],
      "platforms": [
        "web"
      ],
      "source_urls": [
        "http://matterport.com/",
        "https://go.matterport.com/corporate-occupiers.html",
        "https://matterport.com/solutions/design-construction",
        "http://matterport.com/solutions/corporate-real-estate",
        "http://matterport.com/contact-sales"
      ]
    }
  ]
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://matterport.com) rekommenderas starkt för precision. https://matterport.com
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Svar

Nyckel Beskrivning Exempel
products En lista över produkter och tjänster som erbjuds av målföretaget. Returnerar en tom lista när företaget är giltigt men inga produkter eller tjänster identifieras. Lista över Product Object objekt

Product Object

Nyckel Beskrivning Exempel
name Fullständigt produkt- eller tjänstenamn. Distinkta namngivna produkter, SKU:er, plattformar eller separat prissatta erbjudanden returneras som separata rader. "Matterport Digital Twin Platform"
tagline En enrads produktslogan när sådan finns. "Capture, share, and collaborate in immersive 3D."
description En till tre meningar som beskriver vad produkten gör. "Matterport's 3D digital twin platform allows users to create immersive 3D models of physical spaces..."
categories Produktkategorier, inklusive produktklass, bransch eller användningsfallsgrupper som stöds av webbplatsen. ["3D Modeling", "Digital Twins"]
tags Kortfattade produktattribut, driftsättningsstilar, tekniketiketter eller andra sökbara taggar. ["ai-powered", "self-hosted"]
structured_features Funktionskarta med kanoniska funktionsnycklar och booleska, sträng- eller numeriska värden. Nycklar varierar beroende på produktkategori. { "secure_cloud_hosting": true }
freeform_features Funktionsfraser som inte passar in i en kanonisk nyckel. ["unmatched 3D visual clarity"]
pricing Prismodell, startpris och prisnivåer när prissättning är tillgänglig. null när priset inte kan fastställas. Prisobjekt
integrations Produkt-, plattforms- eller tjänstenamn som denna produkt integreras med. ["Procore", "Autodesk", "AWS"]
platforms Plattformar där produkten är tillgänglig, till exempel web, ios, android, macos, windows, linux, api, cli, eller chrome-extension. ["web"]
source_urls URL:er från målföretagets webbplats där produktdata hittades. ["https://matterport.com/solutions/design-construction"]

Prisobjekt

Nyckel Beskrivning Exempel
model Prismodell. Ett av värdena från Enum för prismodell. "subscription"
starts_at_monthly_usd Lägsta månadspris i USD som hittats på företagets webbplats. null när okänt eller otillgängligt. 29.0
tiers Prisnivåer som hittats på företagets webbplats. Lista över PricingTier-objekt objekt

PricingTier-objekt

Nyckel Beskrivning Exempel
name Namn på prisnivå. "Business"
price_usd_monthly Månadspris i USD för denna nivå. null när okänt. 99.0
features Funktioner listade för denna prisnivå. ["SSO", "Audit logs"]

Enum för prismodell

Värde Beskrivning
freemium Gratisplan med betalda uppgraderingar
subscription Återkommande betald prenumeration
one-time Engångsköp
payg Betala per användning
enterprise Anpassad företagsprissättning
unknown Prissättning finns eller kan finnas, men modellen är oklar

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 3
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Webbplatsen är onåbar eller inmatningen är ogiltig
404 Nej Ingen cachad data hittades när use_cache=if-present-only
503 Nej Crawlkapaciteten är tillfälligt mättad. Försök igen efter en kort stund.

Company API

Slutpunkt för företagslogotyp

GET /api/v1/company/logo

Kostnad: 0 kredit / lyckad begäran. (GRATIS)

Hämtar logotypen för ett företag givet dess webbplats-URL. Returnerar logotypen som en PNG-bild (128x128).

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/company/logo" \
  --output logo.png

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompanyAPIApi(api_client)
    logo_data = api.get_company_logo(website="https://www.stripe.com")

    # Save the logo image
    with open("logo.png", "wb") as f:
        f.write(logo_data)

var NinjaPear = require("ninjapear");
var fs = require("fs");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CompanyAPIApi();
api.getCompanyLogo("https://www.stripe.com").then(function (data) {
  // Save the logo image
  fs.writeFileSync("logo.png", Buffer.from(data));
});

Exempelsvar:

Exempel på företagslogotyp

En binär PNG-bildfil (Content-Type: image/png).

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL för målföretaget https://www.stripe.com

Svar

A 200 svaret returnerar logotypen som en råformat PNG-bild med Content-Type: image/png.

Felkoder

Statuskod Debiterad? Beskrivning
404 Nej Ingen logotyp hittades för den angivna domänen

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 0

Slutpunkt för företagsdetaljer

GET /api/v1/company/details

Snitt 10,4 s

Kostnad: 3 krediter / begäran (bas). Lägg till 2 krediter när include_employee_count=true. Lägg till 1 kredit när follower_count=include. Lägg till 2 krediter när addresses=best-effort-exhaustive. Maximalt totalt: 8 krediter. Krediter debiteras även om ingen data hittas.

Hämta detaljer för ett företag utifrån dess webbplats-URL. Returnerar företagsmetadata inklusive beskrivning, bransch, URL:er till sociala medier, det nuvarande ledningsteamet och mer.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/company/details"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompanyAPIApi(api_client)
    details = api.get_company_details(website="https://www.stripe.com")
    print(details)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CompanyAPIApi();
api.getCompanyDetails("https://www.stripe.com").then(function (data) {
  console.log(data);
});

Exempelsvar (privat företag):

{
  "websites": ["https://stripe.com", "https://stripe.dev"],
  "description": "Stripe is a technology company that builds economic infrastructure for the internet.",
  "industry": 45102010,
  "company_type": "PRIVATELY_HELD",
  "founded_year": 2010,
  "specialties": ["Payments", "Financial Services", "APIs"],
  "name": "Stripe",
  "tagline": "Financial infrastructure for the internet",
  "logo_url": "https://nubela.co/api/v1/company/logo?website=https://stripe.com",
  "cover_pic_url": "https://example.com/stripe-cover.png",
  "facebook_url": "https://facebook.com/stripe",
  "twitter_url": "https://twitter.com/stripe",
  "instagram_url": null,
  "employee_count": 8000,
  "addresses": [
    {
      "address_type": "HEADQUARTERS",
      "line1": "354 Oyster Point Blvd",
      "line2": null,
      "city": "South San Francisco",
      "state": "CA",
      "postal_code": "94080",
      "country_code": "US",
      "country": "United States",
      "is_primary": true
    }
  ],
  "executives": [
    {
      "name": "Patrick Collison",
      "title": "Chief Executive Officer",
      "role": "CEO",
      "person_profile_url": "https://nubela.co/api/v2/employee/profile?employer_website=https%3A%2F%2Fstripe.com&first_name=Patrick&last_name=Collison"
    }
  ],
  "similar_companies": "https://nubela.co/api/v1/competitor/listing?website=https%3A%2F%2Fstripe.com",
  "updates": "https://nubela.co/api/v1/company/updates?website=https%3A%2F%2Fstripe.com",
  "funding": "https://nubela.co/api/v1/company/funding?website=https%3A%2F%2Fstripe.com",
  "public_listing": null,
  "follower_count": 272190,
  "following_count": 555
}

Exempelsvar (publikt företag):

{
  "websites": ["https://apple.com"],
  "description": "Apple Inc. designs, manufactures, and markets smartphones, personal computers, tablets, wearables, and accessories worldwide.",
  "industry": 45202030,
  "company_type": "PUBLIC_COMPANY",
  "founded_year": 1976,
  "specialties": ["Consumer Electronics", "Software", "Services"],
  "name": "Apple",
  "tagline": "Think different",
  "logo_url": "https://nubela.co/api/v1/company/logo?website=https://apple.com",
  "cover_pic_url": "https://example.com/apple-cover.png",
  "facebook_url": "https://facebook.com/apple",
  "twitter_url": "https://twitter.com/apple",
  "instagram_url": "https://instagram.com/apple",
  "employee_count": 164000,
  "addresses": [
    {
      "address_type": "HEADQUARTERS",
      "line1": "One Apple Park Way",
      "line2": null,
      "city": "Cupertino",
      "state": "CA",
      "postal_code": "95014",
      "country_code": "US",
      "country": "United States",
      "is_primary": true
    }
  ],
  "executives": [
    {
      "name": "Tim Cook",
      "title": "Chief Executive Officer",
      "role": "CEO",
      "person_profile_url": "https://nubela.co/api/v2/employee/profile?employer_website=https%3A%2F%2Fapple.com&first_name=Tim&last_name=Cook"
    }
  ],
  "similar_companies": "https://nubela.co/api/v1/competitor/listing?website=https%3A%2F%2Fapple.com",
  "updates": "https://nubela.co/api/v1/company/updates?website=https%3A%2F%2Fapple.com",
  "funding": "https://nubela.co/api/v1/company/funding?website=https%3A%2F%2Fapple.com",
  "follower_count": 9500000,
  "following_count": 1,
  "public_listing": {
    "stock_symbol": "AAPL",
    "ipo_date": "1980-12-12",
    "isin": "US0378331005",
    "figi": "BBG000B9XRY4",
    "cusip": "037833100",
    "lei": "HWUPKR0MPOU8FGXBT394",
    "cik": "0000320193",
    "sic_code": "3571",
    "revenue_usd": 383285000000,
    "revenue_captured_at": "2024-09-28",
    "ebitda_usd": 134000000000,
    "ebitda_captured_at": "2024-09-28"
  }
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://www.stripe.com) rekommenderas starkt för precision. https://www.stripe.com
include_employee_count Nej Hämta aktuella data om antal anställda via webbsökning. Lägger till 2 krediter till förfrågningskostnaden. Giltiga värden: true, false (standard). true
follower_count Nej Inkludera antal följare och följda på Twitter/X. Lägger till 1 kredit till begäranskostnaden. Giltiga värden: include. Utelämna eller skicka ett annat värde för att exkludera. include
addresses Nej Adressdetaljläge. Standardvärde är hq-only. Använd best-effort-exhaustive för att hämta och spara företagets fysiska kontorsadresser globalt med bästa möjliga noggrannhet. Lägger till 2 krediter till förfrågningskostnaden. best-effort-exhaustive
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Svar

Nyckel Beskrivning Exempel
websites Lista över alla URL:er till företagets webbplats ["https://stripe.com", "https://stripe.dev"]
description En kort beskrivning av företaget "Stripe is a technology company..."
industry GICS 8-siffrig branschkod 45102010
company_type Typ av företag (PUBLIC_COMPANY, PRIVATELY_HELD, GOVERNMENT_AGENCY, NON_PROFIT, EDUCATIONAL, PARTNERSHIP, SELF_EMPLOYED, SELF_OWNED) "PRIVATELY_HELD"
founded_year Året då företaget grundades 2010
specialties Lista över företagets specialområden ["Payments", "Financial Services"]
name Företagsnamn "Stripe"
tagline Företagets tagline eller slogan "Financial infrastructure for the internet"
logo_url URL till Slutpunkt för företagslogotyp. Autentisera med din API-nyckel bearer token. "https://nubela.co/api/v1/company/logo?website=https://stripe.com"
cover_pic_url URL till företagets omslagsbild/bannerbild "https://example.com/cover.png"
facebook_url Facebook-profil URL "https://facebook.com/stripe"
twitter_url Twitter/X-profil-URL "https://twitter.com/stripe"
instagram_url Instagram-profil-URL null
employee_count Uppskattat antal anställda 8000
employee_count_range_min Nedre gräns för intervallet för antal anställda. Visas endast när include_employee_count=true. 7500
employee_count_range_max Övre gräns för intervallet för antal anställda. Finns endast när include_employee_count=true. 8500
follower_count Antal Twitter/X-följare. Finns endast när follower_count=include. 272190
following_count Antal följda Twitter/X-konton. Finns endast när follower_count=include. 555
addresses Lista över företagets adresser. Standardvärdet är endast huvudkontoret om inte addresses=best-effort-exhaustive begärs. [Adressobjekt]
executives Lista över företagets chefer och styrelseledamöter [Ledningsobjekt]
similar_companies URL till Slutpunkt för konkurrentlista. Autentisera med din bearer token för att hämta konkurrenter. "https://nubela.co/api/v1/competitor/listing?website=https%3A%2F%2Fstripe.com"
updates URL till Slutpunkt för företagsuppdateringar. Autentisera med din bearer token för att hämta uppdateringar. "https://nubela.co/api/v1/company/updates?website=https%3A%2F%2Fstripe.com"
funding URL till Slutpunkt för företagsfinansiering. Autentisera med din bearer token för att hämta finansieringshistorik. "https://nubela.co/api/v1/company/funding?website=https%3A%2F%2Fstripe.com"
public_listing Publikt företagsdata inklusive aktieinformation och finansiell data. null för privata företag. PublicListing Object

Adressobjekt

Nyckel Beskrivning Exempel
address_type Typ av adress (HEADQUARTERS, REGISTERED, BRANCH, MAILING, OTHER) "HEADQUARTERS"
line1 Gatuadress rad 1 "354 Oyster Point Blvd"
line2 Gatuadress rad 2 null
city Stadsnamn "South San Francisco"
state Delstat, provins eller region "CA"
postal_code Postnummer "94080"
country_code ISO 3166-1 alpha-2-landskod "US"
country Fullständigt landsnamn "United States"
is_primary Huruvida detta är den primära adressen true

Ledningsobjekt

Nyckel Beskrivning Exempel
name Chefens fullständiga namn "Patrick Collison"
title Jobbtitel "Chief Executive Officer"
role Normaliserad rolltyp (CEO, CFO, COO, CTO, CMO, PRESIDENT, VICE_PRESIDENT, DIRECTOR, BOARD_MEMBER, CHAIRMAN, FOUNDER, OTHER) "CEO"
person_profile_url Förifylld URL till Slutpunkt för personprofil. Autentisera med din bearer token för att hämta chefens profil. null när förnamn eller företagets webbplats saknas. "https://nubela.co/api/v2/employee/profile?employer_website=https%3A%2F%2Fstripe.com&first_name=Patrick&last_name=Collison"

PublicListing Object

Detta objekt finns bara (icke-null) för publika företag. För privata företag, public_listing kommer att vara null.

Nyckel Beskrivning Exempel
stock_symbol Börssymbol "AAPL"
ipo_date IPO-datum i ISO-format "1980-12-12"
isin Internationellt värdepappersidentifieringsnummer "US0378331005"
figi Financial Instrument Global Identifier "BBG000B9XRY4"
cusip CUSIP-identifierare "037833100"
lei Legal Entity Identifier "HWUPKR0MPOU8FGXBT394"
cik SEC Central Index Key "0000320193"
sic_code SEC Standard Industrial Classification-kod "3571"
revenue_usd Årlig intäkt i USD 383285000000
revenue_captured_at Datum då intäktsdata hämtades (ISO-format) "2024-09-28"
ebitda_usd EBITDA i USD 134000000000
ebitda_captured_at Datum då EBITDA-data hämtades (ISO-format) "2024-09-28"

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 2
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Webbplatsen är onåbar
404 Nej Ingen cachad data hittades när use_cache=if-present-only
404 Ja Ingen företagsdata kunde extraheras från webbplatsen

Slutpunkt för antal anställda

GET /api/v1/company/employee-count

Kostnad: 2 krediter / lyckad förfrågan.

Hämta antalet anställda (intervall) för ett företag utifrån dess webbplats-URL.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/company/employee-count"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompanyAPIApi(api_client)
    response = api.get_employee_count(website="https://www.stripe.com")
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CompanyAPIApi();
api.getEmployeeCount("https://www.stripe.com").then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "employee_count": 3500
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://www.stripe.com) rekommenderas starkt för precision. https://www.stripe.com
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Svar

Nyckel Beskrivning Exempel
employee_count Uppskattat antal anställda 3500

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 2
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Felkoder

Statuskod Debiterad? Beskrivning
404 Nej Ingen data om antal anställda hittades för den angivna webbplatsen
404 Nej Ingen cachad data hittades när use_cache=if-present-only

Slutpunkt för företagsuppdateringar

GET /api/v1/company/updates

Kostnad: 2 krediter / förfrågan.

Hämtar de senaste blogginläggen och X/Twitter-uppdateringarna för ett företag. Returnerar en blandad tidslinje med senaste blogg- och X-inlägg sorterade efter tidsstämpel.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/company/updates"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompanyAPIApi(api_client)
    response = api.get_company_updates(website="https://www.stripe.com")
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CompanyAPIApi();
api.getCompanyUpdates("https://www.stripe.com").then(function (data) {
  console.log(data);
});

Exempelsvar

{
  "blogs": ["https://stripe.com/blog/feed.rss"],
  "x_profile": "https://x.com/stripe",
  "youtube_channels": ["https://www.youtube.com/channel/UCdog0Ap82jpFvSnxorxF_lA"],
  "updates": [
    {
      "url": "https://stripe.com/blog/annual-letter-2024",
      "title": "Stripe's annual letter",
      "description": "A look back at what we built in 2024 and what's ahead.",
      "image_url": null,
      "timestamp": "2025-03-01T12:00:00+00:00",
      "source": "blog"
    },
    {
      "url": "https://x.com/stripe/status/1234567890",
      "title": "We just launched a new feature...",
      "description": "We just launched a new feature that makes payments even easier. Check it out!",
      "image_url": "https://pbs.twimg.com/media/example.jpg",
      "timestamp": "2025-02-28T18:30:00+00:00",
      "source": "x"
    },
    {
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "title": "How Stripe scales payments",
      "description": "A deep dive into the infrastructure behind Stripe payments.",
      "image_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
      "timestamp": "2025-02-20T09:00:00+00:00",
      "source": "youtube"
    }
  ],
  "timestamp": "2025-03-16T10:00:00+00:00"
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://www.stripe.com) rekommenderas starkt för precision. https://www.stripe.com
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 1 dag, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Svar

Nyckel Beskrivning Exempel
blogs Lista över URL:er till blogg-RSS-flöden (om RSS hittades) eller bloggside-URL:er ["https://stripe.com/blog/feed.rss"]
x_profile X/Twitter profil-URL, eller null om ej hittad "https://x.com/stripe"
youtube_channels Lista över YouTube-kanal-URL:er som hittats för företaget, eller tom om inga hittades ["https://www.youtube.com/channel/UCdog0Ap82jpFvSnxorxF_lA"]
updates Lista över uppdateringsobjekt (blogginlägg, tweets och YouTube-videor blandade), sorterade efter tidsstämpel i fallande ordning. Se Uppdateringsobjekt
timestamp UTC-tidsstämpel för när dessa data hämtades "2025-03-16T10:00:00+00:00"

Uppdateringsobjekt

Nyckel Beskrivning Exempel
url URL för blogginlägget, tweeten eller YouTube-videon "https://stripe.com/blog/example"
title Inläggets titel (de första 80 tecknen för tweets) "Stripe's annual letter"
description Inläggsbeskrivning, tweet-text eller videobeskrivning (upp till 500 tecken för bloggar) "A look back at..."
image_url Bild-URL (tweetmedia eller videominiatyrbild), eller null "https://pbs.twimg.com/media/example.jpg"
timestamp ISO 8601-tidsstämpel för publicering, eller null om okänd "2025-03-01T12:00:00+00:00"
source Källtyp för uppdateringen "blog", "x", eller "youtube"

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 2
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 1

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Saknas eller ogiltigt webbplatsparameter
403 Nej Otillräckliga krediter
404 Nej Ingen cachad data hittades när use_cache=if-present-only

Slutpunkt för företagsfinansiering

GET /api/v1/company/funding

Kostnad: 2 krediter / begäran (bas) + 1 kredit per unik investerare returnerad. Grundavgiften gäller fortfarande när ingen finansieringsdata hittas (se error_code: "no_funding_data" nedan).

Hämta finansieringshistorik för ett företag utifrån dess webbplats-URL. Returnerar totalt insamlade medel, enskilda finansieringsrundor med datum och belopp samt deltagande investerare med deras webbplatser.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --max-time 300 \
  --data-urlencode "website=https://www.stripe.com" \
  "https://nubela.co/api/v1/company/funding"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompanyAPIApi(api_client)
    # Set a generous read timeout — calls can take up to 5 minutes.
    response = api.get_company_funding(website="https://www.stripe.com", _request_timeout=300)
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";
defaultClient.timeout = 300000; // 5 minutes

var api = new NinjaPear.CompanyAPIApi();
api.getCompanyFunding("https://www.stripe.com").then(function (data) {
  console.log(data);
});

Exempelsvar

{
  "website": "stripe.com",
  "total_funds_raised_usd": 9810000000,
  "credit_cost": 7,
  "funding_rounds": [
    {
      "round_type": "SECONDARY_SALE",
      "date": "2026-02-01",
      "amount_usd": null,
      "investors": [
        {
          "name": "Thrive Capital",
          "website": "thrivecap.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Coatue",
          "website": "coatue.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Andreessen Horowitz",
          "website": "a16z.com",
          "type": "company",
          "amount_usd": null
        }
      ]
    },
    {
      "round_type": "SERIES_I",
      "date": "2024-04-01",
      "amount_usd": 694200000,
      "investors": [
        {
          "name": "Sequoia Capital",
          "website": "sequoiacap.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Brookfield",
          "website": "brookfield.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Paradigm",
          "website": "paradigm.co",
          "type": "company",
          "amount_usd": null
        }
      ]
    },
    {
      "round_type": "SERIES_I",
      "date": "2023-03-01",
      "amount_usd": 6500000000,
      "investors": [
        {
          "name": "GIC",
          "website": "gic.com.sg",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Goldman Sachs",
          "website": "goldmansachs.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Temasek",
          "website": "temasek.com.sg",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Thrive Capital",
          "website": "thrivecap.com",
          "type": "company",
          "amount_usd": null
        }
      ]
    },
    {
      "round_type": "SERIES_H",
      "date": "2021-03-01",
      "amount_usd": 600000000,
      "investors": [
        {
          "name": "Allianz X",
          "website": "allianzx.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Fidelity",
          "website": "fidelity.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Baillie Gifford",
          "website": "bailliegifford.com",
          "type": "company",
          "amount_usd": null
        }
      ]
    },
    {
      "round_type": "SEED",
      "date": "2011-03-01",
      "amount_usd": 2000000,
      "investors": [
        {
          "name": "Peter Thiel",
          "website": null,
          "type": "angel",
          "amount_usd": null
        },
        {
          "name": "Sequoia Capital",
          "website": "sequoiacap.com",
          "type": "company",
          "amount_usd": null
        },
        {
          "name": "Elon Musk",
          "website": null,
          "type": "angel",
          "amount_usd": null
        }
      ]
    }
  ]
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
webbplats Ja Webbplats-URL eller företagsnamn för målföretaget. En webbplats-URL (t.ex. https://www.stripe.com) rekommenderas starkt för precision. https://www.stripe.com
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Svar

Nyckel Beskrivning Exempel
webbplats Den företagsdomän som svaret beskriver, återgiven från begäran "stripe.com"
total_funds_raised_usd Total finansiering insamlad i USD, eller null om ej uppgiven 9810000000
funding_rounds Array av FundingRound-objekt, sorterade efter datum i fallande ordning Se nedan
credit_cost Totalt antal krediter debiterade för detta anrop (2 bas + 1 per unik investerare). Strömmande svar levererar kreditkostnaden i svarets brödtext i stället för i X-NinjaPear-Credit-Cost header. 7

FundingRound-objekt

Nyckel Beskrivning Exempel
round_type Typ av finansieringsrunda (se rundtypsvärdena nedan) "SERIES_A"
date Datum för rundan i YYYY-MM-DD format, eller null om okänd "2023-03-01"
amount_usd Belopp insamlat i denna runda i USD, eller null om ej uppgiven 600000000
investors Array av Investor-objekt som deltog i denna runda Se nedan

Investerarobjekt

Nyckel Beskrivning Exempel
name Investerarens namn (företag eller privatperson) "Sequoia Capital"
webbplats Webbplatsdomän för investeraren, eller null om okänd "sequoiacap.com"
type Antingen "company" (riskkapitalbolag, fond, företag) eller "angel" (individ) "company"
amount_usd Belopp som denna investerare bidrog med i USD, eller null om ej uppgiven null

Värden för rundtyp

PRE_SEED, SEED, SERIES_A, SERIES_B, SERIES_C, SERIES_D, SERIES_E, SERIES_F, SERIES_G, SERIES_H, SERIES_I genom SERIES_Z, BRIDGE, VENTURE_DEBT, CONVERTIBLE_NOTE, GRANT, SECONDARY_SALE, PRIVATE_EQUITY, GROWTH_EQUITY, IPO, POST_IPO_EQUITY, POST_IPO_DEBT, DEBT_FINANCING, CROWDFUNDING, CORPORATE_ROUND, UNKNOWN

Svarshuvuden

Denna slutpunkt strömmar sitt svar; HTTP-trailers stöds inte, så kreditkostnaden levereras i svarets kropp (the credit_cost fältet) snarare än X-NinjaPear-Credit-Cost header. När svaret levereras från cache returneras X-NinjaPear-Credit-Cost header returneras som vanligt. The X-NinjaPear-Cache-Age-Days header returneras vid lyckade svar för alla use_cache lägen; ny direktberikning returnerar 0.

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop (2 bas + 1 per investerare). Endast cache-träffar. 7
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Felkoder

Klientfel (HTTP 400 / 403) returneras innan strömmande innehåll börjar. Vid cache-missar levereras serverfel som HTTP 200 med error och error_code fälten i svarstexten — eftersom strömningsanslutningen redan har upprättats kan statuskoden inte ändras. Klienter som tidigare förgrenade sig på response.status_code == 404 bör förgrena sig baserat på error_code fältet istället.

Statuskod Debiterad? error_code (body) Beskrivning
400 Nej — Saknas eller ogiltigt webbplatsparameter
403 Nej — Otillräckliga krediter
404 Nej — Ingen cachad data hittades när use_cache=if-present-only
200 (brödtexten innehåller fel) Ja (2 krediter) no_funding_data Ingen finansieringsdata kunde hittas för den angivna webbplatsen. funding_rounds är [].
200 (brödtexten innehåller fel) Nej service_temp_unavailable Tjänsten är tillfälligt otillgänglig. Försök igen senare. funding_rounds är [].

Slutpunkt för webbplatsuppslag

GET /api/v1/company/website

Kostnad: 1 kredit / begäran (debiteras oavsett om en matchning hittas).

Lös upp ett företags namn till dess kanoniska webbplats-URL.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "company_name=Apex" \
  --data-urlencode "country_code=us" \
  --data-urlencode "hint=cybersecurity firm" \
  "https://nubela.co/api/v1/company/website"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.CompanyAPIApi(api_client)
    response = api.get_website_lookup(
        company_name="Apex",
        country_code="us",
        hint="cybersecurity firm",
    )
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.CompanyAPIApi();
api.getWebsiteLookup("Apex", {
  countryCode: "us",
  hint: "cybersecurity firm",
}).then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "website": "https://www.apexsecurity.com"
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
company_name Ja Namnet på det företag som ska sökas upp. Apex
country_code Nej Valfri ISO 3166-1 alpha-2 landskod med 2 bokstäver som används för att geografiskt styra sökningen (t.ex. us, gb, de, sg). Se fullständig lista över ISO 3166-1 alpha-2-koder. Standard är us när det utelämnas. us
tips Nej Ange ett tips för att särskilja likanamnade företag i samma land. cybersecurity firm

Svar

Nyckel Beskrivning Exempel
webbplats Den lösta kanoniska webbplats-URL:en. https://www.stripe.com

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 1

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Saknas eller är ogiltigt company_name parametern.
400 Nej Ogiltigt country_code (inte en erkänd 2-bokstavskod).
404 Ja (1) Ingen webbplatsmatchning kunde hittas för det angivna företagsnamnet.

Employee API

Jobbmail-slutpunkt

GET /api/v1/employee/work-email

Kostnad: 2 krediter vid ett lyckat uppslag (jobbmail hittad). När ingen e-post hittas (work_email är null), en tokenavgift på 0.5 krediter tillämpas — detta motverkar missbruk samtidigt som spekulativa uppslag hålls kostnadseffektiva.

Gör ett bästa möjliga försök att returnera en offentlig jobbmail för en person utifrån deras förnamn (valfritt efternamn) och en företagsdomän.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "first_name=Patrick" \
  --data-urlencode "last_name=Collison" \
  --data-urlencode "domain=stripe.com" \
  "https://nubela.co/api/v1/employee/work-email"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.EmployeeAPIApi(api_client)
    result = api.find_work_email(
        first_name="Patrick",
        last_name="Collison",
        domain="stripe.com",
    )
    print(result)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.EmployeeAPIApi();
api
  .findWorkEmail({
    firstName: "Patrick",
    lastName: "Collison",
    domain: "stripe.com",
  })
  .then(function (data) {
    console.log(data);
  });

Exempelsvar (e-post hittad)

{
  "work_email": "[email protected]"
}

Exempelsvar (inga bevis)

{
  "work_email": null
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
first_name Ja Personens förnamn. Patrick
last_name Nej Personens efternamn. Förbättrar träffsäkerheten när mönstret kräver det. Collison
domain Ja Företagsdomän. Protokoll och sökväg tas bort om de anges. stripe.com

Svar

Nyckel Beskrivning Exempel
work_email Bästa möjliga jobbmail-adress. null om ingen offentlig e-postadress hittades OCH inget mönster kunde härledas. "[email protected]" | null

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Totalt antal krediter debiterade för detta anrop. 2 vid träff; 0.5 vid miss (avgift för token-missbruksskydd). 2 eller 0.5

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Saknas eller är ogiltigt first_name / domain.
403 Nej Otillräckliga krediter.
503 Nej Tjänsten är tillfälligt otillgänglig. Försök igen senare.

Slutpunkt för personprofil

GET /api/v2/employee/profile

Snabb, i genomsnitt 10,5 s Detaljerad genomsn. 38,7 s

Kostnad: 3 krediter / förfrågan. Krediter debiteras även om ingen data hittas.

Berika en anställds yrkesprofil utifrån en jobbmailadress, en kombination av namn och arbetsgivare, eller en kombination av roll och arbetsgivare. Returnerar strukturerade profildata inklusive arbetshistorik, utbildning, plats och närvaro i sociala medier.

Du måste ange minst en av dessa inmatningskombinationer:

Du kan alltid lägga till fler parametrar för att förbättra precisionen. Till exempel, genom att ange work_email tillsammans med first_name, last_name, och role ger bättre resultat än work_email ensam.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://nubela.co/api/v2/employee/profile"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.EmployeeAPIApi(api_client)
    profile = api.get_person_profile_v2(work_email="[email protected]")
    print(profile)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.EmployeeAPIApi();
api.getPersonProfileV2({ workEmail: "[email protected]" }).then(function (data) {
  console.log(data);
});

Exempelsvar

{
  "id": "abc123de-f456-7890-abcd-ef1234567890",
  "slug": "elon-musk",
  "profile_pic_url": "https://pbs.twimg.com/profile_images/1234567890/photo_400x400.jpg",
  "first_name": "Elon",
  "middle_name": "Reeve",
  "last_name": "Musk",
  "full_name": "Elon Reeve Musk",
  "bio": "Mars & Cars, Chips & Dips",
  "follower_count": 195000000,
  "following_count": 782,
  "country": "US",
  "city": "USAUS",
  "state": "US-TX",
  "x_handle": "elonmusk",
  "x_profile_url": "https://x.com/elonmusk",
  "personal_website": "https://elonmusk.com",
  "work_experience": [
    {
      "role": "CEO",
      "company_name": "Tesla",
      "company_website": "tesla.com",
      "description": "Leading Tesla's mission to accelerate the world's transition to sustainable energy.",
      "start_date": "2008-10",
      "end_date": null
    },
    {
      "role": "CEO and CTO",
      "company_name": "SpaceX",
      "company_website": "spacex.com",
      "description": "Founded SpaceX with the goal of reducing space transportation costs and enabling the colonization of Mars.",
      "start_date": "2002-05",
      "end_date": null
    },
    {
      "role": "Co-founder",
      "company_name": "PayPal",
      "company_website": "paypal.com",
      "description": null,
      "start_date": "1999-01",
      "end_date": "2002-10"
    }
  ],
  "education": [
    {
      "major": "B.S. Economics",
      "school": "Wharton School, University of Pennsylvania",
      "start_date": "1992-01",
      "end_date": "1997-01"
    },
    {
      "major": "B.S. Physics",
      "school": "University of Pennsylvania",
      "start_date": "1992-01",
      "end_date": "1997-01"
    }
  ],
  "work_email_lookup": "https://nubela.co/api/v1/employee/work-email?first_name=Elon&last_name=Musk&domain=tesla.com",
  "similar_people": "https://nubela.co/api/v1/employee/similar?id=abc123de-f456-7890-abcd-ef1234567890"
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
work_email Villkorlig Jobbmailadress för personen. Obligatoriskt om employer_website är inte angiven. [email protected]
first_name Villkorlig Personens förnamn. Obligatoriskt vid användning av namn + employer_website kombination. John
middle_name Nej Personens mellannamn. Förbättrar träffsäkerheten i kombination med andra parametrar. Michael
last_name Nej Personens efternamn. Förbättrar träffsäkerheten i kombination med andra parametrar. Smith
employer_website Villkorlig Webbplats-URL eller företagsnamn för personens arbetsgivare. En webbplats-URL rekommenderas starkt för precision. Obligatoriskt om work_email är inte angiven. https://stripe.com
role Nej Aktuell jobbtitel eller roll. Förbättrar noggrannheten. Krävs vid användning av employer_website utan namn. CTO
slug Nej Personslug för direkt uppslag av en befintlig berikad profil. elon-musk
id Nej Person-ID för direkt uppslag av en befintlig berikad profil. abc123de-...
enrichment Nej Styr djupet för liveberikning. Värden: fast (standard; returnerar snabbt och startar detaljerad berikning i bakgrunden), detailed (väntar på detaljerad berikning innan svar returneras).

Ett snabbt svar inkluderar mindre biografisk information, till exempel webbplats och profilbildsdata, men returnerar snabbt strukturerad arbets- och utbildningshistorik.

En snabb berikning startar även detaljerad berikning i bakgrunden, och du har rätt till det resultatet också. Anropa samma förfrågan med samma parametrar och use_cache=if-recent 10 till 30 sekunder senare för att hämta det fullständigt berikade resultatet utan extra kostnad. Sluta polla när X-NinjaPear-Enrichment-Status svarsrubriken är complete. När den detaljerade berikningsprocessen är klar returnerar samma förfrågan den detaljerade cachade profilen utan extra kostnad.

Använd enrichment=fast när du behöver ett snabbt resultat för användningsfall som att fylla i ett UI. Använd enrichment=detailed när du behöver hela svaret och inte har något emot att vänta.		 fast
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Giltiga indatakombinationer

Kombination Exempel
work_email ensam [email protected]
first_name + employer_website ?first_name=John&employer_website=https://stripe.com
employer_website + role ?employer_website=https://stripe.com&role=CTO
slug eller id ?slug=elon-musk

Ytterligare parametrar kan alltid inkluderas för att förbättra resultatets noggrannhet.

Svar

Nyckel Beskrivning Exempel
id Unikt person-ID. Finns när profilen stöds av en sparad personpost. "abc123de-f456-7890-abcd-ef1234567890"
slug Unikt person-slug. Finns när profilen stöds av en sparad personpost. "elon-musk"
profile_pic_url URL till personens profilbild (från X/Twitter). Kan vara null. "https://pbs.twimg.com/.../photo_400x400.jpg"
first_name Förnamn "Elon"
middle_name Mellannamn. Kan vara null. "Reeve"
last_name Efternamn "Musk"
full_name Fullständigt namn "Elon Reeve Musk"
bio Bio/beskrivning från X/Twitter-profil. Kan vara null. "Mars & Cars, Chips & Dips"
follower_count Antal X/Twitter-följare. Kan vara null. 195000000
following_count Antal följda X/Twitter-konton. Kan vara null. 782
country Bosättningsland. ISO 3166-1 alpha-2-kod. "US"
city Bostadsstad. UN/LOCODE. "USAUS"
state Delstat eller region för bosättning. ISO 3166-2 indelningskod. "US-TX"
x_handle X/Twitter-användarnamn (utan @). Kan vara null. "elonmusk"
x_profile_url URL till X/Twitter-profil. Kan vara null. "https://x.com/elonmusk"
personal_website URL till personlig webbplats. Kan vara null. "https://elonmusk.com"
work_experience Lista över arbetshistorikposter, senast först [WorkExperience-objekt]
education Lista över utbildningsposter, senast först [Utbildningsobjekt]
work_email_lookup Förbyggd URL till Jobbmail-slutpunkt för den här personen, med first_name, last_name, och domain (webbplatsen för den senaste arbetslivserfarenheten) redan ifylld. Anropa den direkt med din bearer-token för att lösa upp personens jobbmail — inget behov av att skicka om parametrar. Kostar 2 krediter per anrop. Kan vara null när den nuvarande arbetsgivarens webbplats är okänd. "https://nubela.co/api/v1/employee/work-email?first_name=Elon&last_name=Musk&domain=tesla.com"
similar_people Förbyggd URL till Slutpunkt för liknande personer för den här personen, indexerat efter deras id. Anropa den direkt för att hämta personer med samma roll på konkurrerande företag — du behöver inte skicka sökparametrarna igen. "https://nubela.co/api/v1/employee/similar?id=abc123de-..."

WorkExperience-objekt

Nyckel Beskrivning Exempel
role Jobbtitel eller roll "CEO"
company_name Företagets namn "Tesla"
company_website Företagets webbplatsdomän. Kan vara null. "tesla.com"
description Beskrivning av vad personen gjorde i denna roll. Kan vara null. "Leading Tesla's mission..."
start_date Startdatum i formatet YYYY-MM. Kan vara null. "2008-10"
end_date Slutdatum i formatet ÅÅÅÅ-MM. null innebär att personen för närvarande innehar denna roll. null

Utbildningsobjekt

Nyckel Beskrivning Exempel
major Examen och studieområde "B.S. Economics"
school Skol- eller universitetsnamn "Wharton School, University of Pennsylvania"
start_date Startdatum i formatet YYYY-MM. Kan vara null. "1992-01"
end_date Slutdatum i formatet ÅÅÅÅ-MM. Kan vara null. "1997-01"

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 3
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12
X-NinjaPear-Enrichment-Status Detaljerad berikningstatus för v2 Person Profile-svar. pending innebär att svaret är den snabba profilen och att detaljerad berikning fortfarande körs eller väntar på att slutföras. complete innebär att svaret är den detaljerade cachade profilen eller en enrichment=detailed resultat. Polla tills denna rubrik är complete. complete

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Ogiltiga indata. Måste ange work_email, eller first_name + employer_website, eller employer_website + role.
400 Nej Ogiltigt enrichment. Använd fast eller detailed. Den avvecklade speed parametern accepteras inte.
400 Nej work_email är en personlig/gratis e-postadress (t.ex. [email protected]). Ange en jobbmail för ett företag.
403 Nej Otillräckliga krediter
404 Nej work_email är en rollbaserad / generisk postlåda (t.ex. info@, support@, sales@, noreply@) som inte kan kopplas till en enskild person.
404 Nej Ingen cachad data hittades när use_cache=if-present-only
404 Ja (3 krediter) Ingen profildata kunde hittas för den angivna inmatningen
503 Nej Tjänsten är tillfälligt otillgänglig. Försök igen senare.

Slutpunkt för liknande personer

GET /api/v1/employee/similar

Kostnad: 10 krediter bas + 5 krediter per (företag, roll)-tupel som försöks. Grundkostnaden debiteras oavsett om liknande personer hittas, eftersom slutpunkten förbrukar realtidsberikning för att uppfylla varje förfrågan. Cachelagrade resultat är gratis (se nedan).

Hitta personer som är liknande till en målperson — definierad som personer som innehar samma roll hos konkurrerande företag. Givet ett mål (t.ex. VD:n för nubela.co), identifierar slutpunkten målets nuvarande arbetsgivare, söker upp den arbetsgivarens konkurrenter och försöker berika personen med samma roll hos varje konkurrent i realtid. Svaret returnerar målets profil, listan med (företag, roll) tuplar vi försökte söka och de liknande personer vi framgångsrikt berikade.

Indata är identiska med Slutpunkt för personprofil. Du måste ange minst en av dessa indatakombinationer:

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --max-time 300 \
  --data-urlencode "[email protected]" \
  "https://nubela.co/api/v1/employee/similar"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.EmployeeAPIApi(api_client)
    # Set a generous read timeout — calls can take up to 5 minutes.
    result = api.get_similar_people(work_email="[email protected]", _request_timeout=300)
    print(result)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";
defaultClient.timeout = 300000; // 5 minutes

var api = new NinjaPear.EmployeeAPIApi();
api.getSimilarPeople({ workEmail: "[email protected]" }).then(function (data) {
  console.log(data);
});

Exempelsvar

{
  "target": {
    "first_name": "Tim",
    "last_name": "Cook",
    "full_name": "Tim Cook",
    "work_experience": [
      {
        "role": "CEO",
        "company_name": "Apple",
        "company_website": "apple.com",
        "start_date": "2011-08",
        "end_date": null
      }
    ]
  },
  "attempted_searches": [
    { "employer_website": "samsung.com", "role": "CEO" },
    { "employer_website": "google.com", "role": "CEO" },
    { "employer_website": "microsoft.com", "role": "CEO" },
    { "employer_website": "huawei.com", "role": "CEO" }
  ],
  "similar_people": [
    {
      "first_name": "Sundar",
      "last_name": "Pichai",
      "full_name": "Sundar Pichai",
      "work_experience": [
        {
          "role": "CEO",
          "company_name": "Google",
          "company_website": "google.com",
          "start_date": "2015-08",
          "end_date": null
        }
      ]
    },
    {
      "first_name": "Satya",
      "last_name": "Nadella",
      "full_name": "Satya Nadella",
      "work_experience": [
        {
          "role": "CEO",
          "company_name": "Microsoft",
          "company_website": "microsoft.com",
          "start_date": "2014-02",
          "end_date": null
        }
      ]
    }
  ],
  "credit_cost": 30
}

För korthetens skull visar exemplet ovan bara en delmängd av PersonProfile fälten. Varje post under mål och similar_people är en fullständig PersonProfile objekt — se Svar från slutpunkt för personprofil för det fullständiga schemat, inklusive profile_pic_url, bio, country, x_handle, education, etc.

URL-parametrar

Identisk med URL-parametrar för slutpunkt för personprofil.

Parameter Obligatoriskt Beskrivning Exempel
work_email Villkorlig Jobbmailadress för målpersonen. Obligatoriskt om employer_website är inte angiven. [email protected]
first_name Villkorlig Målets förnamn. Krävs vid användning av namn + employer_website kombination. Tim
middle_name Nej Målets mellannamn. Förbättrar noggrannheten i kombination med andra parametrar. Donald
last_name Nej Målets efternamn. Förbättrar noggrannheten i kombination med andra parametrar. Cook
employer_website Villkorlig Webbplats-URL eller företagsnamn för målets arbetsgivare. En webbplats-URL rekommenderas starkt för precision. Obligatoriskt om work_email är inte angiven. https://apple.com
role Nej Aktuell jobbtitel eller roll. Krävs vid användning av employer_website utan namn. VD

Giltiga indatakombinationer

Kombination Exempel
work_email ensam [email protected]
first_name + employer_website ?first_name=Tim&employer_website=https://apple.com
employer_website + role ?employer_website=https://apple.com&role=CEO

Svar

Nyckel Beskrivning Exempel
mål Den lösta målpersonens fullständiga profil. Samma schema som Slutpunkt för personprofil. { "first_name": "Tim", ... }
attempted_searches Lista över (företag, roll)-tupler som vi försökte berika. En post per konkurrent till målets nuvarande arbetsgivare. Styr faktureringen per tupel (5 krediter per styck). [AttemptedSearch-objekt]
similar_people Lista över framgångsrikt berikade profiler för personer med samma roll på konkurrerande företag. Kan vara en delmängd av attempted_searches (vissa försök returnerar ingen data). Varje post använder samma schema som Slutpunkt för personprofil. [PersonProfile, ...]
credit_cost Totalt antal krediter debiterade för detta anrop. Lika med 10 + 5 * len(attempted_searches), eller 0 för cachelagrade resultat som levereras till samma produkt som tidigare betalat. 30

AttemptedSearch-objekt

Nyckel Beskrivning Exempel
employer_website Konkurrentföretagets webbplatsdomän som vi försökte hämta. "google.com"
role Roll vi sökte efter hos den konkurrenten (speglar målet). "CEO"

Svarshuvuden

Denna slutpunkt strömmar sitt svar, så kreditkostnaden kan inte returneras i ett huvud — HTTP-trailers stöds inte av strömningslagret. Läs credit_cost fältet i svarstexten istället för det vanliga X-NinjaPear-Credit-Cost header.

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Ogiltiga indata. Måste ange work_email, eller first_name + employer_website, eller employer_website + role.
400 Nej work_email är en personlig/gratis e-postadress (t.ex. [email protected]). Ange en jobbmail för ett företag.
403 Nej Otillräckliga krediter. Du behöver minst 10 krediter för att starta en sökning efter liknande personer.
404 Nej work_email är en rollbaserad / generisk postlåda (t.ex. info@, support@, sales@, noreply@) som inte kan kopplas till en enskild person.
404 Nej Målpersonen kunde inte matchas.
503 Nej Resursen är tillfälligt otillgänglig. Försök igen.

Slutpunkt för sökning efter anställda

GET /api/v1/employee/search

Kostnad: bas 2 krediter per anrop (debiteras även när inga anställda returneras), plus 1 kredit per anställd i anställda array. En fråga som returnerar 10 anställda kostar 2 + 10 = 12 krediter.

Hitta nuvarande anställda på ett företag filtrerat efter roll, valfritt avgränsat efter geografi.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "company_website=stripe.com" \
  --data-urlencode "role=VP of Engineering" \
  "https://nubela.co/api/v1/employee/search"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.EmployeeAPIApi(api_client)
    result = api.search_employees(
        company_website="stripe.com",
        role="VP of Engineering",
    )
    print(result)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.EmployeeAPIApi();
api.searchEmployees({
  companyWebsite: "stripe.com",
  role: "VP of Engineering",
}).then(function (data) {
  console.log(data);
});

Exempelsvar

{
  "employees": [
    {
      "first_name": "Jane",
      "last_name": "Doe",
      "role": "VP of Engineering",
      "company_website": "stripe.com",
      "company_details": "https://nubela.co/api/v1/company/details?website=stripe.com",
      "person_profile": "https://nubela.co/api/v2/employee/profile?first_name=Jane&last_name=Doe&employer_website=https%3A%2F%2Fstripe.com",
      "work_email": "https://nubela.co/api/v1/employee/work-email?first_name=Jane&last_name=Doe&domain=stripe.com"
    },
    {
      "first_name": "John",
      "last_name": "Smith",
      "role": "Director of Engineering",
      "company_website": "stripe.com",
      "company_details": "https://nubela.co/api/v1/company/details?website=stripe.com",
      "person_profile": "https://nubela.co/api/v2/employee/profile?first_name=John&last_name=Smith&employer_website=https%3A%2F%2Fstripe.com",
      "work_email": "https://nubela.co/api/v1/employee/work-email?first_name=John&last_name=Smith&domain=stripe.com"
    }
  ]
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
company_website Ja Målföretaget. Föredragen form är en webbplats (ren domän som stripe.com eller fullständig URL som https://stripe.com). Ett företagsnamn (t.ex. Stripe) accepteras också. stripe.com
role Ja Jobbroll för att begränsa sökningen. Matchar relaterade rollvarianter (t.ex. VP of Engineering matchar också Vice President, Engineering). VP of Engineering
country Nej ISO 3166-1 alpha-2-landskod att begränsa med. US
state Nej Delstat eller region att begränsa till (fritext). Kalifornien
city Nej Stad att begränsa till (fritext). San Francisco
use_cache Nej Styr cacheanvändning. Skiftlägesokänslig. Värden: if-recent (standard; använd cachad data när den senaste hämtningen är inom 29 dagar, annars berika live), if-present (returnera cache först, berika live om frånvarande), if-present-only (returnera enbart cache; returnera 404 om frånvarande), never (berika alltid live). Ogiltiga värden faller tillbaka till slutpunktens standard. if-recent

Svar

Nyckel Beskrivning Exempel
anställda Lista över matchande anställda på målföretaget. Tom array om inga hittas. [Anställdobjekt]

Anställdobjekt

Nyckel Beskrivning Exempel
first_name Den anställdes förnamn. "Jane"
last_name Den anställdes efternamn. Kan vara null om ej tillgänglig. "Doe"
role Den anställdes nuvarande jobbtitel på målföretaget. "VP of Engineering"
company_website Webbplats för den anställdes arbetsgivare. Speglar det lösta company_website indataparameter på varje post. "stripe.com"
company_details Förifylld URL till Slutpunkt för företagsdetaljer, ifylld med webbplats. Autentisera med din bearer token för att hämta företagsinformation. "https://nubela.co/api/v1/company/details?website=stripe.com"
person_profile Förifylld URL till Slutpunkt för personprofil, ifylld med first_name, last_name, och employer_website. Anropa direkt med din bearer token för att berika personen. Kostar 3 krediter per anrop. "https://nubela.co/api/v2/employee/profile?first_name=Jane&last_name=Doe&employer_website=https%3A%2F%2Fstripe.com"
work_email Förifylld URL till Jobbmail-slutpunkt, ifylld med first_name, last_name, och domain. Anropa direkt med din bearer token för att fastställa jobbmailen. Kostar 2 krediter vid träff, 0.5 krediter när ingen e-post hittas. "https://nubela.co/api/v1/employee/work-email?first_name=Jane&last_name=Doe&domain=stripe.com"

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Totalt antal krediter debiterade för detta anrop. Lika med 2 + N där N är antalet returnerade anställda (2 när arrayen är tom). 12
X-NinjaPear-Cache-Age-Days Ålder på returnerad data i hela dagar. 0 när färsk data returneras från direktberikning. 12

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Saknas eller är ogiltigt company_website eller role parametern.
403 Nej Otillräckliga krediter. Du behöver minst 2 krediter för att starta en sökning.
404 Nej Ingen cachad data hittades när use_cache=if-present-only
404 Nej Det angivna company_website kunde inte matchas mot ett känt företag.
503 Nej Resursen är tillfälligt otillgänglig. Försök igen.

Meta API

Slutpunkt för att visa kreditsaldo

GET /api/v1/meta/credit-balance

Kostnad: 0 kredit / lyckad begäran.

Hämta ditt aktuella kreditsaldo.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://nubela.co/api/v1/meta/credit-balance"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.MetaAPIApi(api_client)
    response = api.get_credit_balance()
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.MetaAPIApi();
api.getCreditBalance().then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "credit_balance": 100000
}

Svar

Nyckel Beskrivning Exempel
credit_balance Ditt aktuella kreditsaldo 100000

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 0

Felkoder

Statuskod Debiterad? Beskrivning
401 Nej Ogiltig API-nyckel

Kontakt-API

Slutpunkt för kontroll av engångsmailadresser

GET /api/v1/contact/disposable-email

Kostnad: 0 kredit / lyckad begäran. (GRATIS)

Kontrollera om en e-postadress är en engångsmailadress (tillfällig/throwaway) eller en gratis e-postleverantör.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "[email protected]" \
  "https://nubela.co/api/v1/contact/disposable-email"

import ninjapear

configuration = ninjapear.Configuration(
    host="https://nubela.co",
    access_token="YOUR_API_KEY"
)

with ninjapear.ApiClient(configuration) as api_client:
    api = ninjapear.ContactAPIApi(api_client)
    response = api.check_disposable_email(email="[email protected]")
    print(response)

var NinjaPear = require("ninjapear");
var defaultClient = NinjaPear.ApiClient.instance;
defaultClient.authentications["bearerAuth"].accessToken = "YOUR_API_KEY";

var api = new NinjaPear.ContactAPIApi();
api.checkDisposableEmail("[email protected]").then(function (data) {
  console.log(data);
});

Exempelsvar:

{
  "email": "[email protected]",
  "is_disposable_email": true,
  "is_free_email": false
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
e-post Ja E-postadressen att kontrollera [email protected]

Svar

Nyckel Beskrivning Exempel
e-post Den e-postadress som kontrollerades "[email protected]"
is_disposable_email Huruvida e-postdomänen tillhör en känd engångs-/tillfällig e-postleverantör true
is_free_email Huruvida e-postdomänen tillhör en gratis e-postleverantör (t.ex. gmail.com, yahoo.com) false

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 0

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Ogiltigt e-postformat

Monitor API

Monitor API låter dig övervaka uppdateringar från företag. Varje ny uppdatering sammanställs till ett enda RSS-flöde. Systemet övervakar företagsbloggar, X (Twitter)-profiler och webbplatsändringar.

Grundläggande koncept

Hur man använder

Anta att du vill övervaka en grupp konkurrenters webbplatser för blogginlägg, X-aktivitet och webbplatsändringar – allt levererat som ett enda RSS-flöde som du kan ansluta till Feedly, Slack, Zapier eller valfri RSS-läsare.

1. Skapa ett flöde med mål — gruppera de företag du vill övervaka i ett flöde. Varje företag är ett mål identifierat med sin webbplats URL.

curl -X POST \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "SaaS Competitors", "targets": [ { "website_url": "https://stripe.com" }, { "website_url": "https://shopify.com" }, { "website_url": "https://vercel.com" } ] }' \ "https://nubela.co/api/v1/monitor/feeds"

Svaret inkluderar ett rss_url — detta är den URL du prenumererar på.

{ "id": "feed_abc123", "rss_url": "https://nubela.co/.../rss.xml?token=sec_live_..." }

2. Prenumerera på RSS-flödet — kopiera rss_url och lägg till det i valfri RSS-läsare (Feedly, Slack, Zapier, etc.). Blogginlägg, X-inlägg och webbplatsändringar från alla mål visas som objekt i ett enda flöde.

Stripe: Expanding our Payment Network [blog] Vercel on X: "Next.js 16 is here" [x] Shopify: Pricing Page [website update]

Varje post innehåller en kategori (blogg, x, website update, eller website new page). Se Slutpunkt för att konsumera flöde för det fullständiga RSS-schemat.

3. Lägg till nya mål — en ny konkurrent har trätt in på marknaden? Lägg till dem i flödet.

curl -X POST \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "website_url": "https://linear.app" }' \ "https://nubela.co/api/v1/monitor/feeds/feed_abc123/targets"

4. Ta bort mål — ett företag är inte längre relevant? Ta bort det från flödet.

curl -X DELETE \ -H "Authorization: Bearer YOUR_API_KEY" \ "https://nubela.co/api/v1/monitor/feeds/feed_abc123/targets/target_xyz789"

5. Ändra övervakningsinställningar — som standard övervakar varje mål blogginlägg, X-inlägg och webbplatsändringar i en 7-dagarstakt. Använd PATCH för att växla kanaler eller ändra frekvensen.

curl -X PATCH \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "settings": { "monitor_x": false, "frequency_days": 1 } }' \ "https://nubela.co/api/v1/monitor/feeds/feed_abc123/targets/target_xyz789"

Endast de fält du inkluderar ändras — utelämnade fält behåller sina nuvarande värden. Se Inställningsobjekt för alla tillgängliga alternativ.

Priser

Åtgärd Kostnad
Skapa ett flöde 3 krediter (engångskostnad)
Hämtning av blogginlägg (per mål) 1 kredit/hämtning
Webbplatsövervakning hämtning (per mål) 1 kredit/hämtning
X-inlägg uppdateringar hämtning (per mål) 2 krediter/hämtning
YouTube-uppdateringar hämtas (per mål) 1 kredit/hämtning
Alla andra slutpunkter (lista, beskriv, ta bort flöden; hantera mål) 0 krediter

Varje hämtning kontrollerar ett mål för en källa (blogg, X, webbplats eller YouTube). Med alla fyra källor aktiverade kostar ett enda mål 5 krediter per hämtning (1 blogg + 2 X + 1 webbplats + 1 YouTube).

Exempel på månadskostnader

Scenario Mål Frekvens Krediter/månad
VC som spårar 20 portföljföretag 20 Veckovis ~433 krediter (3 engångs + 20 × 5 × 4,3 veckor)
Startup som övervakar 10 konkurrenter 10 Dagligen ~1,503 krediter (3 engångs + 10 × 5 × 30 dagar)
Säljteam som bevakar 5 prospektkonton (blogg + X enbart, ingen webbplats) 5 Dagligen ~453 krediter (3 engångs + 5 × 3 × 30 dagar)

Engångskostnaden för att skapa ett flöde (3 krediter) ingår endast den första månaden.

Slutpunkt för listning av flöden

GET /api/v1/monitor/feeds

Kostnad: 0 krediter / förfrågan.

Hämtar en lista över alla flöden som ägs av den autentiserade användaren.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://nubela.co/api/v1/monitor/feeds"

Exempelsvar:

{
  "feeds": [
    {
      "id": "feed_abc123",
      "name": "SaaS Competitors",
      "is_public": false,
      "rss_url": "https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml?token=sec_live_987654321",
      "created_at": "2026-02-24T00:00:00Z",
      "target_count": 2
    }
  ]
}

Svar

Nyckel Beskrivning Exempel
feeds Lista över flödesobjekt Se Flödesobjekt

Flödesobjekt

Nyckel Beskrivning Exempel
id Unik flödesidentifierare "feed_abc123"
name Flödesnamn "SaaS Competitors"
is_public Huruvida flödet är offentligt tillgängligt false
is_suspended Huruvida flödet för närvarande är pausat false
suspension_reason Anledning till avstängning, om avstängd null eller "insufficient_credits"
rss_url RSS-flödets URL. För privata flöden inkluderas en token-frågeparameter. "https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml?token=sec_live_987654321"
email_notifications Läge för e-postmeddelanden "skip" eller "on_updates"
created_at ISO 8601-tidsstämpel för skapande "2026-02-24T00:00:00Z"
target_count Antal mål i flödet 2

Ny slutpunkt för flöde

POST /api/v1/monitor/feeds

Kostnad: 3 krediter / förfrågan (engångsavgift).

Skapar ett nytt flöde och accepterar valfritt en array med initiala mål.

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SaaS Competitors",
    "is_public": false,
    "targets": [
      {
        "website_url": "https://stripe.com",
        "settings": {
          "monitor_blog": true,
          "monitor_x": true,
          "monitor_website": true,
          "monitor_youtube": true,
          "frequency_days": 7
        }
      },
      {
        "website_url": "https://vercel.com"
      }
    ]
  }' \
  "https://nubela.co/api/v1/monitor/feeds"

Exempelsvar 201 Created:

{
  "id": "feed_abc123",
  "name": "SaaS Competitors",
  "is_public": false,
  "is_suspended": false,
  "suspension_reason": null,
  "rss_url": "https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml?token=sec_live_987654321",
  "created_at": "2026-02-24T09:55:00Z",
  "targets": [
    {
      "id": "target_xyz789",
      "website_url": "https://stripe.com",
      "settings": {
        "monitor_blog": true,
        "monitor_x": true,
        "monitor_website": true,
        "monitor_youtube": true,
        "frequency_days": 7
      },
      "last_polled_at": null,
      "is_baseline_complete": false,
      "created_at": "2026-02-24T09:55:00Z"
    },
    {
      "id": "target_xyz790",
      "website_url": "https://vercel.com",
      "settings": {
        "monitor_blog": true,
        "monitor_x": true,
        "monitor_website": true,
        "monitor_youtube": true,
        "frequency_days": 7
      },
      "last_polled_at": null,
      "is_baseline_complete": false,
      "created_at": "2026-02-24T09:55:00Z"
    }
  ]
}

Förfrågningskropp

Parameter Obligatoriskt Beskrivning Exempel
name Nej Namn på flödet. Om det utelämnas genereras ett namn automatiskt. "SaaS Competitors"
is_public Nej Huruvida flödet är offentligt tillgängligt (standard: false) false
email_notifications Nej Läge för e-postmeddelanden. "on_updates" för att ta emot e-post när nya uppdateringar upptäcks, "skip" för att inaktivera (standard: "skip") "on_updates"
targets Ja Array av initiala mål att lägga till i flödet (minst 1 krävs) Se Inmatningsobjekt för mål

Inmatningsobjekt för mål

Parameter Obligatoriskt Beskrivning Exempel
website_url Ja Webbplats-URL för företaget som ska övervakas "https://stripe.com"
settings Nej Övervakningsinställningar. Om de utelämnas tillämpas standardvärden. Se Inställningsobjekt

Inställningsobjekt

Parameter Obligatoriskt Beskrivning Exempel
monitor_blog Nej Övervaka företagets blogg för nya inlägg (standard: true) true
monitor_x Nej Övervaka företagets X (Twitter)-konto (standard: true) true
monitor_website Nej Övervaka företagets webbplats för innehållsändringar och nya sidor (standard: true) true
monitor_youtube Nej Övervaka företagets officiella YouTube-kanal för nya videor (standard: true) true
frequency_days Nej Hur ofta uppdateringar ska kontrolleras, i dagar. Måste vara mellan 1 och 30 (standard: 7) 7

Valideringsregler

Svar

Returnerar 201 Created. Svaret inkluderar det skapade Flödesobjekt med ytterligare targets array som innehåller Målobjekt poster.

Målobjekt

Nyckel Beskrivning Exempel
id Unik målidentifierare "target_xyz789"
website_url Den övervakade företagets webbplats-URL "https://stripe.com"
settings Objekt för övervakningsinställningar Se Inställningsobjekt
last_polled_at ISO 8601-tidsstämpel för senaste avsökning, eller null om aldrig avsökt null
is_baseline_complete Huruvida den initiala referenssnapskotten har tagits false
created_at ISO 8601-tidsstämpel för skapande "2026-02-24T09:55:00Z"

Svarshuvuden

Header-nyckel Beskrivning Exempel
X-NinjaPear-Credit-Cost Total kreditkostnad för detta API-anrop 3

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Valideringsfel (saknade mål, onåbar URL, inga övervakningsflaggor aktiverade)

Slutpunkt för att beskriva flöde

GET /api/v1/monitor/feeds/{feed_id}

Kostnad: 0 krediter / förfrågan.

Hämtar fullständiga detaljer för ett enskilt flöde, inklusive alla dess kopplade mål.

curl -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123"

Exempelsvar:

{
  "id": "feed_abc123",
  "name": "SaaS Competitors",
  "is_public": false,
  "is_suspended": false,
  "suspension_reason": null,
  "rss_url": "https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml?token=sec_live_987654321",
  "created_at": "2026-02-24T09:55:00Z",
  "targets": [
    {
      "id": "target_xyz789",
      "website_url": "https://stripe.com",
      "settings": {
        "monitor_blog": true,
        "monitor_x": true,
        "monitor_website": true,
        "monitor_youtube": true,
        "frequency_days": 7
      },
      "last_polled_at": "2026-02-24T12:00:00Z",
      "is_baseline_complete": true,
      "created_at": "2026-02-24T09:55:00Z"
    },
    {
      "id": "target_xyz790",
      "website_url": "https://vercel.com",
      "settings": {
        "monitor_blog": true,
        "monitor_x": true,
        "monitor_website": true,
        "monitor_youtube": true,
        "frequency_days": 7
      },
      "last_polled_at": null,
      "is_baseline_complete": false,
      "created_at": "2026-02-24T09:55:00Z"
    }
  ]
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för flödet feed_abc123

Svar

Returnerar ett Flödesobjekt med ytterligare targets array som innehåller Målobjekt poster.

Felkoder

Statuskod Debiterad? Beskrivning
404 Nej Flödet hittades inte

Slutpunkt för att ta bort flöde

DELETE /api/v1/monitor/feeds/{feed_id}

Kostnad: 0 krediter / förfrågan.

Tar permanent bort ett flöde och alla tillhörande mål.

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123"

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för det flöde som ska tas bort feed_abc123

Svar

Returnerar 200 OK med ett bekräftelsemeddelande.

{
  "message": "Feed deleted."
}

Felkoder

Statuskod Debiterad? Beskrivning
404 Nej Flödet hittades inte

Lägg till mål-slutpunkt

POST /api/v1/monitor/feeds/{feed_id}/targets

Kostnad: 0 krediter / förfrågan.

Lägger till ett nytt företag i ett befintligt flöde.

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_url": "https://shopify.com",
    "settings": {
      "monitor_blog": true,
      "monitor_x": true,
      "monitor_website": false,
      "frequency_days": 3
    }
  }' \
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123/targets"

Exempelsvar 201 Created:

{
  "id": "target_xyz791",
  "website_url": "https://shopify.com",
  "settings": {
    "monitor_blog": true,
    "monitor_x": true,
    "monitor_website": false,
    "frequency_days": 3
  },
  "last_polled_at": null,
  "is_baseline_complete": false,
  "created_at": "2026-02-24T10:00:00Z"
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för det flöde som målet ska läggas till i feed_abc123

Förfrågningskropp

Parameter Obligatoriskt Beskrivning Exempel
website_url Ja Webbplats-URL för företaget som ska övervakas "https://shopify.com"
settings Nej Övervakningsinställningar. Om de utelämnas tillämpas standardvärden. Se Inställningsobjekt

Svar

Returnerar ett Målobjekt.

Felkoder

Statuskod Debiterad? Beskrivning
404 Nej Flödet hittades inte

Slutpunkt för uppdatering av mål

PATCH /api/v1/monitor/feeds/{feed_id}/targets/{target_id}

Kostnad: 0 krediter / förfrågan.

Ändrar övervakningsinställningarna för ett specifikt mål.

curl -X PATCH \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "settings": {
      "frequency_days": 1,
      "monitor_website": true
    }
  }' \
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123/targets/target_xyz789"

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för flödet feed_abc123
target_id Ja ID:t för det mål som ska uppdateras target_xyz789

Förfrågningskropp

Parameter Obligatoriskt Beskrivning Exempel
settings Ja Partiell uppdatering av inställningar. Endast angivna fält ändras. Se Inställningsobjekt

Svar

Returnerar det uppdaterade Målobjekt.

Exempelsvar:

{
  "id": "target_xyz789",
  "website_url": "https://stripe.com",
  "settings": {
    "monitor_blog": true,
    "monitor_x": true,
    "monitor_website": true,
    "monitor_youtube": true,
    "frequency_days": 1
  },
  "last_polled_at": "2026-02-24T12:00:00Z",
  "is_baseline_complete": true,
  "created_at": "2026-02-24T09:55:00Z"
}

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Inga giltiga inställningar angavs
404 Nej Flödet eller målet hittades inte

Ta bort mål-slutpunkt

DELETE /api/v1/monitor/feeds/{feed_id}/targets/{target_id}

Kostnad: 0 krediter / förfrågan.

Slutar övervaka en webbplats och tar bort den från flödet.

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123/targets/target_xyz789"

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för flödet feed_abc123
target_id Ja ID:t för det mål som ska tas bort target_xyz789

Svar

Returnerar 200 OK med ett bekräftelsemeddelande.

{
  "message": "Target deleted."
}

Felkoder

Statuskod Debiterad? Beskrivning
404 Nej Flödet eller målet hittades inte

Slutpunkt för att konsumera flöde

GET /api/v1/monitor/feeds/{feed_id}/rss.xml

Kostnad: 0 krediter / förfrågan (övervakningskostnader debiteras per hämtning för varje mål — se Priser).

Returnerar ett standard RSS 2.0 XML-flöde som konsumeras av RSS-läsare (Feedly, Slack, webbläsartillägg m.m.).

Om flödets is_public är false, en giltig token måste skickas som en token frågeparametern.

curl "https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml?token=YOUR_RSS_TOKEN"

Exempelsvar:

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/">
<channel>
  <title>SaaS Competitors</title>
  <link>https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml</link>
  <description>Automated updates for Stripe, Shopify, and Vercel.</description>
  <lastBuildDate>Tue, 24 Feb 2026 10:00:00 +0800</lastBuildDate>

  <item>
    <title>Stripe: Expanding our Global Payment Network</title>
    <link>https://stripe.com/blog/global-network-2026</link>
    <guid isPermaLink="true">https://stripe.com/blog/global-network-2026</guid>
    <pubDate>Mon, 23 Feb 2026 14:30:00 +0800</pubDate>
    <category>blog</category>
    <dc:creator>Stripe</dc:creator>
    <description>Stripe is expanding its payments infrastructure to 15 new countries, enabling merchants to accept local payment methods seamlessly.</description>
    <enclosure url="https://b.stripecdn.com/blog/og-global-network.jpg" length="150000" type="image/jpeg" />
  </item>

  <item>
    <title>Vercel on X: "Next.js 16 is here..."</title>
    <link>https://x.com/vercel/status/123456789</link>
    <guid isPermaLink="false">x_post_123456789</guid>
    <pubDate>Sun, 22 Feb 2026 10:15:00 +0800</pubDate>
    <category>x</category>
    <dc:creator>Vercel</dc:creator>
    <description>Next.js 16 is here, featuring completely redesigned server components and faster builds. Read the changelog.</description>
    <enclosure url="https://pbs.twimg.com/media/vercel-next16.jpg" length="85000" type="image/jpeg" />
  </item>

  <item>
    <title>Shopify: Pricing Page</title>
    <link>https://shopify.com/pricing</link>
    <guid isPermaLink="false">website_update_shopify_pricing_1708416000</guid>
    <pubDate>Fri, 20 Feb 2026 08:00:00 +0800</pubDate>
    <category>website update</category>
    <dc:creator>Shopify</dc:creator>
    <description>Compare Shopify's pricing plans to find the best fit for your business. Start your free trial today.</description>
    <enclosure url="https://cdn.shopify.com/assets/og-pricing.png" length="210000" type="image/png" />
  </item>

  <item>
    <title>Shopify: Enterprise Plus Solutions</title>
    <link>https://shopify.com/enterprise-plus</link>
    <guid isPermaLink="true">https://shopify.com/enterprise-plus</guid>
    <pubDate>Thu, 19 Feb 2026 11:20:00 +0800</pubDate>
    <category>website new page</category>
    <dc:creator>Shopify</dc:creator>
    <description>Unleash your brand's potential with Shopify Enterprise Plus. High-volume solutions for global commerce.</description>
    <enclosure url="https://cdn.shopify.com/assets/og-enterprise.jpg" length="320000" type="image/jpeg" />
  </item>

</channel>
</rss>

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för flödet feed_abc123

Svarsformat

Svaret är ett standard-RSS 2.0 XML-dokument. Strukturen är följande:

Kanalelement

Element Beskrivning Exempel
<title> Flödets namn SaaS Competitors
<link> URL för RSS-flödet https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml
<description> Automatiskt genererad sammanfattning av övervakade företag Automated updates for Stripe, Shopify, and Vercel.
<lastBuildDate> RFC 2822-tidsstämpel för det senaste flödesbygget Tue, 24 Feb 2026 10:00:00 +0800

Objekt­element

Varje <item> representerar en enskild uppdatering från ett övervakat företag.

Element Beskrivning Exempel
<title> Uppdateringsrubrik med företagsnamnet som prefix Stripe: Expanding our Global Payment Network
<link> URL för det ursprungliga innehållet https://stripe.com/blog/global-network-2026
<guid> Unik identifierare för posten. isPermaLink är true när GUID:et är en URL. https://stripe.com/blog/global-network-2026
<pubDate> RFC 2822-publiceringsstämpel Mon, 23 Feb 2026 14:30:00 +0800
<category> Uppdateringstyp (se kategorier nedan) blogg
<dc:creator> Företagsnamn (använder Dublin Core-namnrymden) Stripe
<description> Sammanfattning eller utdrag ur uppdateringen Textinnehåll
<enclosure> Valfri bildbilaga med url, length (byte), och type (MIME-typ) attribut <enclosure url="..." length="150000" type="image/jpeg" />

RSS-objektkategorier

Varje <item> inkluderar en <category> element som anger uppdateringstypen:

Kategori Beskrivning
blogg Ett nytt blogginlägg från företaget
x Ett inlägg från företagets X (Twitter)-konto
website update En förändring upptäckt på en befintlig sida
website new page En ny sida upptäckt på företagets webbplats
website unreachable Företagets webbplats har blivit onåbar (utlöses en gång)

Felkoder

Statuskod Debiterad? Beskrivning
403 Nej Saknas eller ogiltigt token för ett privat flöde
404 Nej Flödet hittades inte

Slutpunkt för uppdatering av flöde

PATCH /api/v1/monitor/feeds/{feed_id}

Kostnad: 0 krediter / förfrågan.

Uppdatera flödesinställningar som namn, synlighet eller uppehållsstatus. Flöden som pausats i insufficient_credits återupptas automatiskt när krediter läggs till.

# Suspend a feed
curl -X PATCH \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_suspended": true, "suspension_reason": "manual" }' \
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123"

import requests

response = requests.patch(
    "https://nubela.co/api/v1/monitor/feeds/feed_abc123",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"is_suspended": True, "suspension_reason": "manual"},
)

const response = await fetch(
  "https://nubela.co/api/v1/monitor/feeds/feed_abc123",
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ is_suspended: true, suspension_reason: "manual" }),
  },
);

Exempelsvar (samma som Describe Feed):

{
  "id": "feed_abc123",
  "name": "My Feed",
  "is_public": false,
  "is_suspended": true,
  "suspension_reason": "manual",
  "rss_url": "https://nubela.co/api/v1/monitor/feeds/feed_abc123/rss.xml?token=...",
  "created_at": "2025-01-15T10:30:00Z",
  "targets": [...]
}

URL-parametrar

Parameter Obligatoriskt Beskrivning Exempel
feed_id Ja ID:t för flödet feed_abc123

Förfrågningskropp

Parameter Obligatoriskt Beskrivning Exempel
name Nej Nytt flödesnamn "My Feed"
is_public Nej Huruvida RSS-flödet är offentligt tillgängligt true
is_suspended Nej Ange true för att pausa, false för att återuppta true
suspension_reason Nej Anledning till avstängning (endast när is_suspended är true, standard "manual") "manual"
email_notifications Nej Läge för e-postmeddelanden. "on_updates" för att ta emot e-post när nya uppdateringar upptäcks, "skip" för att inaktivera "on_updates"

Minst ett fält måste anges.

Svar

Returnerar det uppdaterade Flödesobjekt med ytterligare targets array som innehåller Målobjekt poster.

Felkoder

Statuskod Debiterad? Beskrivning
400 Nej Inga giltiga fält angavs
404 Nej Flödet hittades inte

Claude AI

NinjaPear tillhandahåller en MCP (Model Context Protocol)-server för direkt integration med Claude. Detta låter dig ställa frågor om B2B-företagsdata i konversationsform — fråga Claude om ett företags kunder, investerare, antal anställda och mycket mer.

Snabbstart

  1. Hämta din anslutningssträng från Instrumentpanel
  2. Lägg till NinjaPear som en koppling i Claude (se installationsanvisningar nedan)
  3. Starta ett nytt samtal och fråga efter B2B-företagsdata i konversationsform

Konfiguration

Din anslutningssträng finns på Instrumentpanel. Det ser ut så här: https://nubela.co/mcp/sse?api_key=YOUR_API_KEY

Claude Platform (Rekommenderas)

  1. Hämta din anslutningssträng från Instrumentpanel
  2. Se till att du är inloggad i Claude och besök sedan: Lägg till anpassad koppling
  3. Ange följande:
    • Namn: NinjaPear
    • URL till fjärr-MCP-server: Klistra in din anslutningssträng från steg 1
  4. Klicka Lägg till koppling
  5. Starta ett nytt samtal och be Claude använda NinjaPear

Claude Code CLI

Hämta din anslutningssträng från Instrumentpanel, kör sedan:

claude mcp add ninjapear --transport sse "YOUR_CONNECTOR_STRING"

Tillgängliga verktyg

Verktyg Beskrivning Kostnad
get_customer_listing Hämta kunder, investerare och partners för ett företag 1 + 2/företag
get_company_details Hämta företagsinformation, chefer och finansiella uppgifter 2–4 krediter
get_employee_count Hämta antal anställda för ett företag 2 krediter
check_disposable_email Kontrollera om e-post är engångs/gratis GRATIS
get_credit_balance Kontrollera ditt kreditsaldo GRATIS
get_company_logo_url Hämta företagets logotyp-URL GRATIS
list_feeds Lista alla dina övervakningsflöden 0 krediter
create_feed Skapa ett nytt övervakningsflöde med mål 3 krediter
describe_feed Hämta flödesdetaljer med alla mål 0 krediter
update_feed Uppdatera flödets namn, synlighet eller uppehållsstatus 0 krediter
delete_feed Ta bort ett flöde och alla dess mål 0 krediter
add_target Lägg till ett företag att övervaka i ett flöde 0 krediter
update_target Uppdatera övervakningsinställningar för ett mål 0 krediter
remove_target Ta bort ett företag från ett flöde 0 krediter
consume_feed Läs de senaste uppdateringarna från ett flöde GRATIS

Exempelpromptar

När du är ansluten kan du ställa frågor till Claude som:

Konkurrensunderrättelse

Du är en produktchef som följer vad dina konkurrenter gör.

VC-portföljövervakning

Du är en VC som vill hålla koll på portföljföretagens aktivitet. Ladda upp en CSV eller skärmbild av dina portföljföretag till Claude och fråga sedan:

Säljprospektering

Du arbetar med försäljning och vill undersöka konton innan du kontaktar dem.

Marknadsundersökning

Du är en analytiker som kartlägger en branschlandskap.

Övervakning och aviseringar

Du vill konfigurera löpande övervakning och återkomma för att kontrollera uppdateringar.

Kontohantering

Snabbkontroller av din NinjaPear-användning.

Felhantering

Fel returneras som beskrivande meddelanden som Claude förklarar för dig:

Fel Meddelande
Ogiltig API-nyckel "Error: 401 Unauthorized"
Otillräckliga krediter "Error: 402 Payment Required"
Hastighetsbegränsad "Error: 429 Too Many Requests"
Serverfel "Error: 500 Internal Server Error"

Tekniska detaljer

MCP Protocol

NinjaPear MCP-servern implementerar Model Context Protocol specifikationen, som är Anthropics öppna standard för att ansluta AI-assistenter till externa datakällor och verktyg.

Transport

Vi använder Server-Sent Events (SSE)-transport för realtidskommunikation:

Autentisering

Skicka din API-nyckel via api_key frågeparametern eller X-API-Key header

cURL Python JavaScript