PoliAPI Docs v1

This is the documentation for PoliAPI v1

Overview

PoliAPI is designed to offer transparent and accessible data on the trading activities of government officials. PoliAPI provides detailed endpoints for querying trade data based on various criteria.

Host

All requests use the host https://api.poliapi.com

Requests to https://poliapi.com/api will be redirected to https://api.poliapi.com

Authentication

Authentication is not currently required.

Error Handling

Error Response Format: Errors are returned with a status code and a message.

Common Status Codes:

200 OK: Request succeeded.

400 Bad Request: Invalid request format or parameters.

404 Not Found: Endpoint or resource not found.

500 Internal Server Error: Server-side error.

GET Trades

By Politician

Returns a list of all trades made by a certain politician.

Endpoint

https://api.poliapi.com/api/politician/ (politician_name)

Parameters

Politician Name | First and Last Name Separated by a Space

Example Request

GET https://api.poliapi.com/api/politician/

Example Response

json
{
"Politician Name" : "Marjorie Taylor Greene"
"Politician Party" : "Republican"
"Politician Position" : "House"
"Politician State" : "GA"
"Price" : "N/A"
"Publish Date" : "2024-06-28"
"Reporting Gap" : 3
"Size" : "1K–15K"
"Trade Issuer" : "ASML Holding NV"
"Traded Date" : "2024-06-24"
"Type" : "buy"
}

,

{
"Politician Name" : "Marjorie Taylor Greene"
"Politician Party" : "Republican"
"Politician Position" : "House"
"Politician State" : "GA"
"Price" : 164.66
"Publish Date" : "2024-05-21"
"Reporting Gap" : 0
"Size" : "1K–15K"
"Trade Issuer" : "Advanced Micro Devices Inc"
"Traded Date" : "2024-05-21"
"Type" : "buy"
}

,

{
"Politician Name" : "Marjorie Taylor Greene"
"Politician Party" : "Republican"
"Politician Position" : "House"
"Politician State" : "GA"
"Price" : 192.35
"Publish Date" : "2024-05-21"
"Reporting Gap" : 0
"Size" : "1K–15K"
"Trade Issuer" : "Apple Inc"
"Traded Date" : "2024-05-21"
"Type" : "buy"
}

,

{
"Politician Name" : "Marjorie Taylor Greene"
"Politician Party" : "Republican"
"Politician Position" : "House"
"Politician State" : "GA"
"Price" : 219.65
"Publish Date" : "2024-07-25"
"Reporting Gap" : 1
"Size" : "1K–15K"
"Trade Issuer" : "Applied Materials Inc"
"Traded Date" : "2024-07-25"
"Type" : "buy"
}

,

{
"Politician Name" : "Marjorie Taylor Greene"
"Politician Party" : "Republican"
"Politician Position" : "House"
"Politician State" : "GA"
"Price" : "N/A"
"Publish Date" : "2024-06-28"
"Reporting Gap" : 3
"Size" : "1K–15K"
"Trade Issuer" : "ASML Holding NV"
"Traded Date" : "2024-06-24"
"Type" : "buy"
}

continues...

By Published Date

Returns a list of all trades published within the given number of weeks.

Endpoint

https://api.poliapi.com/api/published_within/ (number of weeks)

Parameters

Weeks | Numerical Number of Weeks Worth of Recent Trades

Example Request

GET https://api.poliapi.com/api/published_within/1

Example Response

json
{
"Politician Name:" : "Michael McCaul",
"Politician Party:" : "Republican",
"Politician Position:" : "Senate",
"Politician State:" : "TX",
"Price:" : "22.41",
"Publish Date:" : "2024-07-23",
"Reporting Gap:" : "31",
"Size:" : "1K–15K",
"Trade Issuer:" : "Vishay Intertechnology Inc",
"Traded Date:" : "2024-06-21",
"Type:" : "buy"
}

,

{
"Politician Name:" : "Michael McCaul",
"Politician Party:" : "Republican",
"Politician Position:" : "Senate",
"Politician State:" : "TX",
"Price:" : "22.50",
"Publish Date:" : "2024-07-23",
"Reporting Gap:" : "32",
"Size:" : "1K–15K",
"Trade Issuer:" : "Vishay Intertechnology Inc",
"Traded Date:" : "2024-06-20",
"Type:" : "buy"
}

,

{
"Politician Name:" : "Michael McCaul",
"Politician Party:" : "Republican",
"Politician Position:" : "Senate",
"Politician State:" : "TX",
"Price:" : "22.29",
"Publish Date:" : "2024-07-23",
"Reporting Gap:" : "38",
"Size:" : "1K–15K",
"Trade Issuer:" : "Vishay Intertechnology Inc",
"Traded Date:" : "2024-06-14",
"Type:" : "buy"
}

,

{
"Politician Name:" : "Michael McCaul",
"Politician Party:" : "Republican",
"Politician Position:" : "Senate",
"Politician State:" : "TX",
"Price:" : "38.15",
"Publish Date:" : "2024-07-23",
"Reporting Gap:" : "38",
"Size:" : "1K–15K",
"Trade Issuer:" : "Sensata Technologies Holding PLC",
"Traded Date:" : "2024-06-14",
"Type:" : "buy"
}

,

{
"Politician Name:" : "Victoria Spartz",
"Politician Party:" : "Republican",
"Politician Position:" : "House",
"Politician State:" : "IN",
"Price:" : "151.80",
"Publish Date:" : "2024-07-26",
"Reporting Gap:" : "27",
"Size:" : "50K–100K",
"Trade Issuer:" : "Simon Property Group Inc",
"Traded Date:" : "2024-06-28",
"Type:" : "buy"
}

,continues...

By Traded Date

Returns a list of all trades traded within the given number of weeks.

Endpoint

https://api.poliapi.com/api/traded_within/ (number of weeks)

Parameters

Weeks | Numerical Number of Weeks Worth of Recent Trades

Example Request

GET https://api.poliapi.com/api/traded_within/1

Example Response

json

{
"Politician Name:" : "Marjorie Taylor Greene",
"Politician Party:" : "Republican",
"Politician Position:" : "House",
"Politician State:" : "GA",
"Price:" : "N/A",
"Publish Date:" : "2024-07-25",
"Reporting Gap:" : "0",
"Size:" : "250K–500K",
"Trade Issuer:" : "US TREASURY BILLS",
"Traded Date:" : "2024-07-24",
"Type:" : "buy"
}

,

{
"Politician Name:" : "Buddy Carter",
"Politician Party:" : "Republican",
"Politician Position:" : "House",
"Politician State:" : "GA",
"Price:" : "61.05",
"Publish Date:" : "2024-07-25",
"Reporting Gap:" : "1",
"Size:" : "100K–250K",
"Trade Issuer:" : "Ameris Bancorp",
"Traded Date:" : "2024-07-23",
"Type:" : "sell"
}

,

{
"Politician Name:" : "Katie Britt",
"Politician Party:" : "Republican",
"Politician Position:" : "Senate",
"Politician State:" : "AL",
"Price:" : "N/A",
"Publish Date:" : "2024-07-29",
"Reporting Gap:" : "5",
"Size:" : "1K–15K",
"Trade Issuer:" : "ONEWATER MARINE INC",
"Traded Date:" : "2024-07-24",
"Type:" : "sell"
}

,

{
"Politician Name:" : "Katie Britt",
"Politician Party:" : "Republican",
"Politician Position:" : "Senate",
"Politician State:" : "AL",
"Price:" : "26.83",
"Publish Date:" : "2024-07-29",
"Reporting Gap:" : "5",
"Size:" : "1K–15K",
"Trade Issuer:" : "ONEWATER MARINE INC",
"Traded Date:" : "2024-07-24",
"Type:" : "sell"
}

,continues...

By Trade Type

Returns a list of all trades of a certain 'type'.

Endpoint

https://api.poliapi.com/api/type/ (type)

Parameters

Type | 'Buy' / 'Sell' / 'Exchange'

Example Request

GET https://api.poliapi.com/api/type/buy

Example Response

json

{
"Politician Name:" : "Hal Rogers"
"Politician Party:" : "Republican"
"Politician Position:" : "House"
"Politician State:" : "KY"
"Price:" : "N/A"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "20"
"Size:" : "15K–50K"
"Trade Issuer:" : "FRANKLIN COUNTY SCHOOL DISTRICT"
"Traded Date:" : "2024-06-20"
"Type:" : "buy"
}

,

{
"Politician Name:" : "Rick Allen"
"Politician Party:" : "Republican"
"Politician Position:" : "House"
"Politician State:" : "GA"
"Price:" : "N/A"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "15"
"Size:" : "250K–500K"
"Trade Issuer:" : "US TREASURY BILLS"
"Traded Date:" : "2024-06-25"
"Type:" : "buy"
}

,

{
"Politician Name:" : "Michael Collins"
"Politician Party:" : "Republican"
"Politician Position:" : "House"
"Politician State:" : "GA"
"Price:" : "0.78"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "19"
"Size:" : "1K–15K"
"Trade Issuer:" : "AERODROME FINANCE"
"Traded Date:" : "2024-06-22"
"Type:" : "buy"
}

,

{
"Politician Name:" : "John Boozman"
"Politician Party:" : "Republican"
"Politician Position:" : "Senate"
"Politician State:" : "AR"
"Price:" : "31.77"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "37"
"Size:" : "1K–15K"
"Trade Issuer:" : "Goldman Sachs ActiveBeta Emerging Markets Equity ETF"
"Traded Date:" : "2024-06-04"
"Type:" : "buy"
}

,continues...

By Trade Size

Returns all exchanges who's total price fall within a given range.

Endpoint

https://api.poliapi.com/api/size/ (size)

Parameters

Size:

0 | 1K-15K

1 | 15K-50K

2 | 50K-100K

3 | 100K-250K

4 | 250K-500K

5 | 500K-1M

6 | 1M-5M

7 | 5M-25M

8 | 25M-50M

Why?

When politicians publish their trades, they are not required to provide the exact amount of the exchange. Instead, they report the value within a specified range.

Example Request

GET https://api.poliapi.com/api/type/buy

Example Response

json

{
"Politician Name:" : "Hal Rogers"
"Politician Party:" : "Republican"
"Politician Position:" : "House"
"Politician State:" : "KY"
"Price:" : "N/A"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "20"
"Size:" : "15K–50K"
"Trade Issuer:" : "FRANKLIN COUNTY SCHOOL DISTRICT"
"Traded Date:" : "2024-06-20"
"Type:" : "buy"
}

,

{
"Politician Name:" : "Rick Allen"
"Politician Party:" : "Republican"
"Politician Position:" : "House"
"Politician State:" : "GA"
"Price:" : "N/A"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "15"
"Size:" : "250K–500K"
"Trade Issuer:" : "US TREASURY BILLS"
"Traded Date:" : "2024-06-25"
"Type:" : "buy"
}

,

{
"Politician Name:" : "Michael Collins"
"Politician Party:" : "Republican"
"Politician Position:" : "House"
"Politician State:" : "GA"
"Price:" : "0.78"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "19"
"Size:" : "1K–15K"
"Trade Issuer:" : "AERODROME FINANCE"
"Traded Date:" : "2024-06-22"
"Type:" : "buy"
}

,

{
"Politician Name:" : "John Boozman"
"Politician Party:" : "Republican"
"Politician Position:" : "Senate"
"Politician State:" : "AR"
"Price:" : "31.77"
"Publish Date:" : "2024-07-11"
"Reporting Gap:" : "37"
"Size:" : "1K–15K"
"Trade Issuer:" : "Goldman Sachs ActiveBeta Emerging Markets Equity ETF"
"Traded Date:" : "2024-06-04"
"Type:" : "buy"
}

,continues...

By Trade Issuer

Returns a list of all trades performed through a certain trade issuer.

Endpoint

https://api.poliapi.com/api/issuer/ (trade issuer)

Parameters

Issuer | Name of Issuer / Company

Example Request

GET https://api.poliapi.com/api/issuer/Apple Inc

Example Response

json

{
"Politician Name" : "Ro Khanna"
"Politician Party" : "Democrat"
"Politician Position" : "House"
"Politician State" : "CA"
"Price" : "186.19"
"Publish Date" : "2024-02-07"
"Reporting Gap" : "26"
"Size" : "1K–15K"
"Trade Issuer" : "Apple Inc"
"Traded Date" : "2024-01-10"
"Type" : "buy"
}

,

{
"Politician Name" : "Ro Khanna"
"Politician Party" : "Democrat"
"Politician Position" : "House"
"Politician State" : "CA"
"Price" : "186.19"
"Publish Date" : "2024-02-07"
"Reporting Gap" : "26"
"Size" : "15K–50K"
"Trade Issuer" : "Apple Inc"
"Traded Date" : "2024-01-10"
"Type" : "buy"
}

,

{
"Politician Name" : "Markwayne Mullin"
"Politician Party" : "Republican"
"Politician Position" : "Senate"
"Politician State" : "OK"
"Price" : "185.64"
"Publish Date" : "2024-01-27"
"Reporting Gap" : "24"
"Size" : "50K–100K"
"Trade Issuer" : "Apple Inc"
"Traded Date" : "2024-01-02"
"Type" : "buy"
}

,

{
"Politician Name" : "Blake Moore"
"Politician Party" : "Republican"
"Politician Position" : "House"
"Politician State" : "UT"
"Price" : "191.56"
"Publish Date" : "2024-01-24"
"Reporting Gap" : "5"
"Size" : "15K–50K"
"Trade Issuer" : "Apple Inc"
"Traded Date" : "2024-01-19"
"Type" : "sell"
}

,continues...

By Price

Returns a list of all trades with an exchange price within the queried constraints.

Endpoint

https://api.poliapi.com/api/price/(condition)/(price target)

Parameters

Condition | Over / Under / N/A (No Price)

Price Target | Numerical Price Target for Query

Example Request

GET https://api.poliapi.com/api/price/over/100

Example Response

json

{
"Politician Name" : "Markwayne Mullin"
"Politician Party" : "Republican"
"Politician Position" : "Senate"
"Politician State" : "OK"
"Price" : "532.96"
"Publish Date" : "2024-07-12"
"Reporting Gap" : "30"
"Size" : "15K–50K"
"Trade Issuer" : "Parker-Hannifin Corp"
"Traded Date" : "2024-06-12"
"Type" : "buy"
}

,

{
"Politician Name" : "Markwayne Mullin"
"Politician Party" : "Republican"
"Politician Position" : "Senate"
"Politician State" : "OK"
"Price" : "295.68"
"Publish Date" : "2024-07-12"
"Reporting Gap" : "29"
"Size" : "500K–1M"
"Trade Issuer" : "iShares Russell 1000 ETF"
"Traded Date" : "2024-06-13"
"Type" : "sell"
}

,

{
"Politician Name" : "Shelley Moore Capito"
"Politician Party" : "Republican"
"Politician Position" : "Senate"
"Politician State" : "WV"
"Price" : "263.07"
"Publish Date" : "2024-07-11"
"Reporting Gap" : "14"
"Size" : "1K–15K"
"Trade Issuer" : "Air Products and Chemicals Inc"
"Traded Date" : "2024-06-27"
"Type" : "sell"
}

,

{
"Politician Name" : "John Boozman"
"Politician Party" : "Republican"
"Politician Position" : "Senate"
"Politician State" : "AR"
"Price" : "534.24"
"Publish Date" : "2024-07-11"
"Reporting Gap" : "37"
"Size" : "1K–15K"
"Trade Issuer" : "SPDR MidCap 400 ETF Trust"
"Traded Date" : "2024-06-04"
"Type" : "sell"
}

,continues...

Rate Limits

No current rate limits.

Contact Information

Feel free to ask questions and leave suggestions at contactus@poliapi.com

Versioning

PoliAPI v1