E-post Outreach-katalog

Färska press-e-mails grupperade efter bransch.

API FAQ

Hämta API-nyckel Köp krediter

Endpoint:

99.9 % Drifttid

918ms Svar

20 req/s

0.01 Krediter / förfrågan

List Press Releases


POST https://api.yeb.to/v1/outreach/list

Parameter	Typ	Oblig.	Beskrivning
`api_key`	string	ja	Your API key
`category`	string	valfri	Filter by category (e.g. Technology, Healthcare & Pharma)
`days`	integer	valfri	Only show press releases from the last N days (0 = all time)
`page`	integer	valfri	Page number (default: 1)
`per_page`	integer	valfri	Results per page, max 100 (default: 20)

Exempel

curl -X POST https://api.yeb.to/v1/outreach/list \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "category": "Technology",
  "days": 7,
  "page": 1,
  "per_page": 20
}'

Svarsexempel

{
  "data": [
    {
      "id": 42581,
      "summary": "TechCorp announces new AI platform for enterprise automation",
      "category": "Technology",
      "added_at": "2026-03-11T08:30:00+00:00",
      "mails": [
        { "mail": "[email protected]", "unlocked": true },
        { "mail": "j***@reuters.com", "unlocked": false }
      ]
    }
  ],
  "total": 1842,
  "page": 1,
  "per_page": 20,
  "last_page": 93
}

{"error":"Invalid API key","code":401}

Svarskoder

Kod	Beskrivning
200 Success	Förfrågan behandlad OK.
400 Bad Request	Indatavalidering misslyckades.
401 Unauthorized	Saknad / felaktig API-nyckel.
403 Forbidden	Nyckel inaktiv eller ej tillåten.
429 Rate Limit	För många förfrågningar.
500 Server Error	Oväntat fel.

List Press Releases

outreach/list 0.0100 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Code Samples

Response

Status: —

Headers

Body

Unlock Emails


POST https://api.yeb.to/v1/outreach/unlock

Parameter	Typ	Oblig.	Beskrivning
`api_key`	string	ja	Your API key
`mails`	array	ja	Array of email addresses to unlock

Exempel

curl -X POST https://api.yeb.to/v1/outreach/unlock \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "mails": ["[email protected]", "[email protected]"]
}'

Svarsexempel

{
  "emails": ["[email protected]", "[email protected]"],
  "new_unlocked": 2,
  "already_unlocked": 0,
  "credits_charged": 2.0
}

{"error":"Insufficient credits. Need 2, have 0.5","code":402}

Svarskoder

Kod	Beskrivning
200 Success	Förfrågan behandlad OK.
400 Bad Request	Indatavalidering misslyckades.
401 Unauthorized	Saknad / felaktig API-nyckel.
403 Forbidden	Nyckel inaktiv eller ej tillåten.
429 Rate Limit	För många förfrågningar.
500 Server Error	Oväntat fel.

Unlock Emails

outreach/unlock 1.0000 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Emails

body · string · required

Code Samples

Response

Status: —

Headers

Body

List Categories


POST https://api.yeb.to/v1/outreach/categories

Parameter	Typ	Oblig.	Beskrivning
`api_key`	string	ja	Your API key

Exempel

curl -X POST https://api.yeb.to/v1/outreach/categories \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY"
}'

Svarsexempel

{
  "categories": [
    { "name": "Business & Finance", "count": 4521 },
    { "name": "Technology", "count": 3892 },
    { "name": "Healthcare & Pharma", "count": 2104 },
    { "name": "Entertainment & Media", "count": 1847 }
  ],
  "total": 15
}

{"error":"Invalid API key","code":401}

Svarskoder

Kod	Beskrivning
200 Success	Förfrågan behandlad OK.
400 Bad Request	Indatavalidering misslyckades.
401 Unauthorized	Saknad / felaktig API-nyckel.
403 Forbidden	Nyckel inaktiv eller ej tillåten.
429 Rate Limit	För många förfrågningar.
500 Server Error	Oväntat fel.

List Categories

outreach/categories 0.0010 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Code Samples

Response

Status: —

Headers

Body

Export Contacts


POST https://api.yeb.to/v1/outreach/export

Parameter	Typ	Oblig.	Beskrivning
`api_key`	string	ja	Your API key
`format`	string	valfri	Export format: json or csv (default: json)
`category`	string	valfri	Filter exported contacts by category

Exempel

curl -X POST https://api.yeb.to/v1/outreach/export \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_KEY",
  "format": "json",
  "category": "Technology"
}'

Svarsexempel

{
  "data": [
    {
      "email": "[email protected]",
      "category": "Technology",
      "summary": "TechCorp announces new AI platform",
      "added_at": "2026-03-11 08:30:00"
    },
    {
      "email": "[email protected]",
      "category": "Technology",
      "summary": "Reuters covers enterprise automation trend",
      "added_at": "2026-03-10 14:15:00"
    }
  ],
  "total": 2,
  "format": "json"
}

{"error":"Authentication required","code":401}

Svarskoder

Kod	Beskrivning
200 Success	Förfrågan behandlad OK.
400 Bad Request	Indatavalidering misslyckades.
401 Unauthorized	Saknad / felaktig API-nyckel.
403 Forbidden	Nyckel inaktiv eller ej tillåten.
429 Rate Limit	För många förfrågningar.
500 Server Error	Oväntat fel.

Export Contacts

outreach/export 0.0500 credits

Method

URL

Authentication

API Key

Parameters

API Key

body · string · required

Format

body · string

Code Samples

Response

Status: —

Headers

Body

Vanliga frågor

Varje kontakt extraheras från ett betalt pressmeddelande eller gästinlägg via partnertjänster. Företaget har redan investerat i distribution och söker därför aktivt mediebevakning.

Nya pressmeddelanden samlas in dagligen från flera nyhetstjänster. Du kan filtrera efter aktualitet (1, 7 eller 30 dagar) för att bara få de senaste kontakterna.

1 kredit låser upp 1 helt ny e-postadress. Redan upplåsta e-postadresser är gratis att komma åt igen. List- och kategoriändpunkterna kostar en bråkdel av en kredit.

Ja. Använd exportändpunkten för att ladda ner alla dina upplåsta kontakter som JSON eller CSV, valfritt filtrerade efter kategori.

E-postadresser du inte har låst upp ännu är delvis maskerade (t.ex. j***@example.com). Efter upplåsning returneras den fullständiga adressen i alla efterföljande förfrågningar.

Ja. Varje förfrågan, även de som resulterar i fel, förbrukar krediter. Dina krediter är kopplade till antalet förfrågningar, oavsett framgång eller misslyckande. Om felet tydligt beror på ett plattformsproblem på vår sida återställer vi de berörda krediterna (ingen kontant återbetalning).

Kontakta oss på [email protected]. Vi tar feedback på allvar—om din felrapport eller funktionsbegäran är meningsfull kan vi snabbt fixa eller förbättra API:et och ge dig 50 gratis krediter som tack.

Det beror på API:et och ibland till och med på endpointen. Vissa endpoints använder data från externa källor, som kan ha striktare gränser. Vi tillämpar också gränser för att förhindra missbruk och hålla vår plattform stabil. Kontrollera dokumentationen för den specifika gränsen för varje endpoint.

Vi arbetar med ett kreditsystem. Krediter är förbetalda, icke-återbetalningsbara enheter du spenderar på API-anrop och verktyg. Krediter förbrukas FIFO (äldst först) och gäller i 12 månader från inköpsdatumet. Instrumentpanelen visar varje inköpsdatum och dess utgång.

Ja. Alla köpta krediter (inklusive bråkdelssaldon) gäller i 12 månader från köpet. Oanvända krediter förfaller automatiskt och raderas permanent i slutet av giltighetsperioden. Förfallna krediter kan inte återställas eller konverteras till kontanter eller annat värde. Övergångsregel: krediter köpta före 22 sept. 2025 behandlas som köpta den 22 sept. 2025 och förfaller den 22 sept. 2026 (om inte ett tidigare utgångsdatum angavs vid köpet).

Ja—inom sin giltighetsperiod. Oanvända krediter förblir tillgängliga och överförs från månad till månad tills de förfaller 12 månader efter köpet.

Krediter är icke-återbetalningsbara. Köp bara det du behöver—du kan alltid fylla på senare. Om ett plattformsfel orsakar en misslyckad debitering kan vi återställa de berörda krediterna efter utredning. Ingen kontant återbetalning.

Priserna anges i krediter, inte i dollar. Varje endpoint har sin egen kostnad—se märket "Krediter / förfrågan" ovan. Du vet alltid exakt vad du spenderar.

← Tillbaka till API:er

K\u00f6p krediter f\u00f6r att l\u00e5sa upp premiuminneh\u00e5ll och funktioner

Kundtyp

Faktureringsland

API / Slutpunkt

Valuta

Antal f\u00f6rfr\u00e5gningar

E-post Outreach-katalog

List Press Releases

Exempel

Svarsexempel

Svarskoder

List Press Releases

Parameters

Code Samples

Response

Unlock Emails

Exempel

Svarsexempel

Svarskoder

Unlock Emails

Parameters

Code Samples

Response

List Categories

Exempel

Svarsexempel

Svarskoder

List Categories

Parameters

Code Samples

Response

Export Contacts

Exempel

Svarsexempel

Svarskoder

Export Contacts

Parameters

Code Samples

Response

Vanliga frågor

Varifrån kommer e-postkontakterna?

Hur färska är kontakterna?

Hur fungerar prissättningen?

Kan jag exportera kontakter?

Varför är vissa e-postadresser maskerade?

Räknas förfrågningar med fel och kostar de krediter?

Jag hittade en bugg eller vill ha anpassningar i API:erna. Vad gör jag?

Vad är hastighetsgränsen?

Hur fungerar betalning och användning?

Går krediter ut?

Överförs oanvända krediter?

Erbjuder ni återbetalningar?

Vad kostar varje API-anrop?