Sell & Buy API

Connect your platform to Sampleeye

The Sell & Buy API is how another panel or survey platform connects to Sampleeye. Buyers use it to request respondents, and panels use it to offer their members to Sampleeye projects.

Talk to sales About Sampleeye

A drawn exchange between a partner platform and Sampleeye: a buy-side request for 200 completes, then one outcome record per start.

Sell & Buy API

Project requestyour platform to Sampleeye

{  "side": "buy",  "country": "US",  "audience": "Parents of teenagers",  "completes": 200,  "survey_link": "<your survey link>"}

Outcome backone record per start

{  "start": "S-20431",  "outcome": "complete",  "decided_by": "your survey"}{  "start": "S-20432",  "outcome": "screen-out",  "decided_by": "Sampleeye"}

Field names come with the partner documentation, shared once a connection is agreed.

Why it matters

Email and spreadsheets slow sample down

When projects, quotas and outcomes move between two companies by email, every change waits for someone to read it. A direct connection lets both systems share the same project details and the same outcomes.

Buy side and sell side

What each side gets

Sampleeye sits in the middle. Each side talks to it in the same few messages, and every start ends in one outcome.

Buy-side partnerA platform that hosts surveys

SampleeyeProjects and outcomes

Sell-side partnerA panel with its own members

Buy side

Request respondents for surveys you host, from the people Sampleeye can reach, including PocketsFull members.

Project request: audience, country, completes and the survey link
Respondents who fit, sent to the survey
One outcome for each start

Sell side

Offer your own panel members to Sampleeye projects that fit their profile, and get paid for their completes.

Projects that fit the members’ profiles
Members start the survey
An outcome code for each finished survey; completes are paid

One list of outcomes

Both sides close a project from the same five outcomes

Closing a project means matching two copies of one list, not two spreadsheets.

CompleteReached the end of the survey
Screen-outTurned away by a screening question
Over quotaQualified, but the group was already full
Security terminateStopped by a security or quality check
Drop-outLeft before the end

Getting connected

How a connection gets set up

Three steps, agreed in order. Nothing goes live before a test project has run.

New connectionTest before live traffic

01
Tell us your side
Say whether you want to buy sample, sell it, or both, and in which countries.
Your team
02
Agree the terms
We agree audiences, prices and how outcomes are reported before anything is connected.
Both sides
03
Connect and test
Your developers connect with the access and documentation we share, and we run a test project before live traffic.
Your developers, with us

Access and documentation are shared once a connection is agreed.

Example

Example: selling and buying through the API

A US panel company has more members than surveys to send them. On the sell side, its members are offered Sampleeye projects that match their profile, and each finished survey comes back with an outcome code. On the buy side, a survey platform asks Sampleeye for 200 completes from US parents of teenagers for a study it hosts.

Buy sideA survey platform200 completes from US parents of teenagers

Completes164 / 200

Complete164
Screen-out118
Over quota21
Security terminate5
Drop-out30

338 starts so far, each with one outcome

Sell sideA US panel companyIts members, offered projects that fit their profile

Complete128
Screen-out61
Over quota14
Security terminate3
Drop-out22

228 starts, each back with an outcome code; 128 completes paid

FAQ

Questions, answered

Is the API open to new partners?

Talk to us first. We agree scope and terms with each partner before giving access.

Where is the documentation?

We share it with partners once a connection is agreed. Ask our team for a copy.

Can I reach PocketsFull members through the API?

PocketsFull members receive their surveys through Sampleeye, so buy-side projects can include them when they fit the audience.

Talk to us about a connection

Tell us whether you buy, sell or both, which countries you cover, and roughly how many completes a month you expect.